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

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

注

この記事の URL は、https://api.contoso.comなど、API のデプロイ時に選択されたホスト名を基準にしています。

依頼

メソッド	要求 URL
取得する	/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 要求ヘッダーと応答ヘッダー を参照してください。

リクエストの本文

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

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

応答

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

応答コード

コード	説明
200	わかりました
204	コンテンツなし
403	禁じられた
500	内部エラー

応答ヘッダー

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

応答内容

成功した場合は、次のプロパティを持つ Microsoft.Clm.Shared.Smartcards.Smartcard オブジェクト JSON-Serialized を返します。

名前	説明
AssignedUserUuid	スマート カードが割り当てられているユーザーの識別子。
Atr	現在初期化されているカードのスマート カードのリセット応答 (ATR) 文字列。
コメント	スマート カードを説明するコメント。
フラグ	スマート カードを記述するフラグ。
ミドルウェア	スマート カードのミドルウェア。
ParentSmartcardUuid	スマート カードが置き換えた古いスマート カードの識別子。
PermanentSmartcardUuid	スマート カードに関連付けられている永続的なスマート カードの識別子。
PrimarySmartcardUuid	プライマリ スマート カードの識別子。
ProfileTemplateUuid	スマート カードを管理するポリシーと設定を含むプロファイル テンプレートの識別子。
ProfileTemplateVersion	スマート カード プロファイルが作成された時点のプロファイル テンプレートのバージョン。
シリアルナンバー	スマート カードのシリアル番号。
ステータス	スマート カードの状態。
ユニバーサリー・ユニーク・アイデンティファイア (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"
}

こちらもご覧ください

• Microsoft.Clm.Shared.Smartcards.Smartcard クラス