スマート カードの分散管理キーを取得する
指定したスマート カードの分散管理キーを取得します。
重要
管理者キーは、プロファイル テンプレート ポリシーで必要と示されている場合にのみ、分散させる必要があります。
注意
この記事の URL は、 などの https://api.contoso.comAPI デプロイ中に選択されたホスト名に対する相対 URL です。
Request
| Method | 要求 URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}/diversifiedkey |
URL パラメーター
| パラメーター | 説明 |
|---|---|
| reqid | 必須です。 Microsoft Identity Manager (MIM) 証明書管理 (CM) に固有の要求識別子。 |
| scid | 必須です。 MIM CM に固有のスマート カード識別子。 scid は、 Microsoft.Clm.Shared.Smartcards.Smartcard オブジェクトから取得されます。 |
クエリ パラメーター
| パラメーター | 説明 |
|---|---|
| atr | 省略可能。 スマート カードの ATR (Answer To Reset) 文字列。 |
| cardid | 必須です。 カード ID。 |
要求ヘッダー
一般的な要求ヘッダーについては、「CM REST API サービスの詳細」の「HTTP 要求ヘッダーと応答ヘッダー」を参照してください。
要求本文
なし。
Response
このセクションでは、応答について説明します。
応答コード
| コード | 説明 |
|---|---|
| 200 | OK |
| 204 | コンテンツはありません |
| 403 | Forbidden |
| 500 | 内部エラー |
応答ヘッダー
一般的な応答ヘッダーについては、「CM REST API サービスの詳細」の「HTTP 要求ヘッダーと応答ヘッダー」を参照してください。
応答本文
成功すると、分散された管理キーを表す BLOB バイトを返します。
例
このセクションでは、スマート カードの多様な管理キーを取得する例を示します。
例: 要求
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9/diversifiedkey?cardid=bc88f13f-83ba-4037-8262-46eba1291c6e HTTP/1.1
例: 応答
HTTP/1.1 200 OK
"mBVA+HopB/gc+6FuKsQqx+OX01hK1WQI"