取得智慧卡多樣化管理金鑰
取得指定智慧卡的多元管理金鑰。
重要
只有在設定檔範本原則指出應該有時，系統管理金鑰才應該多樣化。
注意
本文中的 URL 相對於 API 部署期間所選擇的主機名稱，例如 https://api.contoso.com 。
要求
| 方法 | 要求 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) 字串。 |
| cardid | 必要。 卡片識別碼。 |
要求標頭
如需常見的要求標頭，請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。
要求本文
無。
回應
本節說明回應。
回應碼
| 程式碼 | 描述 |
|---|---|
| 200 | [確定] |
| 204 | 沒有內容 |
| 403 | 禁止 |
| 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"