スマート カード プロファイルを取得する

ユーザーのスマート カード プロファイルの一覧を取得します。 この一覧には、現在のユーザーが実行できる操作が含まれています。 指定した操作のいずれかに対して、要求を開始できます。

Note

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

Request

Method 要求 URL
GET /CertificateManagement/api/v1.0/smartcards
/CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL パラメーター

プロパティ 説明
smartcarduuid 任意。 スマート カードの UUID は、Microsoft Identity Manager (MIM) 証明書管理 (CM) で示されます。 値は 、Microsoft.Clm.Shared.Smartcards.Smartcard オブジェクト の "uuid" フィールドに対応します。

クエリ パラメーター

プロパティ 説明
cardid 任意。 CM で示されるスマート カード UUID MIMします。 値は 、Microsoft.Clm.Shared.Smartcards.Smartcard オブジェクト の "uuid" フィールドに対応します。

要求ヘッダー

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

要求本文

[なし] :

Response

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

応答コード

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

応答ヘッダー

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

応答本文

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

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

このセクションでは、ユーザーのスマート カード プロファイルを取得する例を示します。

例: 要求 1

GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1

例: 応答 1

HTTP/1.1 200 OK

{
    "Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
    "Status":3,
    "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":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

例: 要求 2

GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

例: 応答 2

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":2,
    "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"
}

関連項目