次の方法で共有


スマート カードの状態を更新する

スマート カードの状態を更新します。

Note

この記事の URL は、API のデプロイ中に選択されたホスト名 (など https://api.contoso.com) に対して相対的です。

Request

Method 要求 URL
GET /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

URL パラメーター

パラメーター 説明
reqid 必須です。 Microsoft Identity Manager (MIM) 証明書管理 (CM) に固有の要求識別子。
scid 必須です。 MIM CM に固有のスマート カード識別子。 値は、 Microsoft.Clm.Shared.Smartcards.Smartcard オブジェクトの "uuid" フィールドに対応します。

要求ヘッダー

一般的な要求ヘッダーについては、「CM REST API サービスの詳細」の HTTP 要求ヘッダーと応答ヘッダーに関するページを参照してください。

要求本文

要求本文には、次のプロパティが含まれています。

プロパティ 説明
status 要求をに設定する状態 ("廃止済み" など)。

Response

このセクションでは、応答について説明します。

応答コード

コード 説明
200 OK
204 コンテンツはありません
403 Forbidden
500 内部エラー

応答ヘッダー

一般的な応答ヘッダーについては、「CM REST API サービスの詳細」の HTTP 要求ヘッダーと応答ヘッダーに関するページを参照してください。

応答本文

成功した場合、JSON でシリアル化された Microsoft.Clm.Shared.Smartcards.Smartcard オブジェクトと次のプロパティを返します。

名前 説明
AssignedUserUuid スマート カードが割り当てられるユーザーの識別子。
Atr 現在初期化中のカードに対するスマート カード ATR (Answer To Reset) 文字列。
解説 スマート カードを説明するコメント。
Flags スマート カードについて説明するフラグ。
ミドルウェア スマート カードのミドルウェア。
ParentSmartcardUuid スマート カードが置き換えた古いスマート カードの識別子。
PermanentSmartcardUuid スマート カードに関連付けられた永続的なスマート カードの識別子。
PrimarySmartcardUuid プライマリ スマート カードの識別子。
ProfileTemplateUuid スマート カードを管理するポリシーと設定を含むプロファイル テンプレートの識別子。
ProfileTemplateVersion スマート カード プロファイルの作成時点でのプロファイル テンプレートのバージョン。
SerialNumber スマート カードのシリアル番号。
Status スマート カードの状態。
Uuid スマート カード プロファイルの識別子。

このセクションでは、スマート カードの状態を更新する例を示します。

例: 要求

PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

例: 応答

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":6,
    "Flags":1,
    "ParentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PrimarySmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "PermanentSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "AssignedUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "ProfileTemplateVersion":46,
    "Comment":"",
    "SerialNumber":"{bc88f13f-83ba-4037-8262-46eba1291c6e}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

関連項目