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

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

注

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

依頼

メソッド	要求 URL
取得する	/CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL パラメーター

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

クエリ パラメーター

プロパティ	説明
cardid	随意。 MIM CM で示されるスマート カード UUID。 値は、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)	スマート カード プロファイルの識別子。

例

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

例: 要求 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"
}

こちらもご覧ください

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