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

  • [アーティクル]

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

注意

この記事の URL は、 などの https://api.contoso.comAPI デプロイ中に選択されたホスト名に対する相対 URL です。

Request

Method 要求 URL
GET /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 要求ヘッダーと応答ヘッダー」を参照してください。

要求本文

なし。

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 スマート カード プロファイルの識別子。

例

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

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

関連項目