スマート カードの状態を更新する
スマート カードの状態を更新します。
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"
}