取得智慧卡設定檔

發行項
09/14/2023

取得使用者的智慧卡配置檔案清單。此清單包含目前使用者可以執行的可能作業。然後，任何指定的作業即可起始要求。

注意

本文中的 URL 相對於 API 部署期間所選擇的主機名稱，例如 https://api.contoso.com 。

要求

方法	要求 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 要求和回應標頭。

要求本文

無。

回應

本節描述回應。

回應碼

程式碼	描述
200	[確定]
204	沒有內容
403	禁止
500	內部錯誤

回應標頭

如需常見的回應標頭，請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭。

回應本文

成功時，傳回包含下列屬性的 JSON 序列化 Microsoft.Clm.Shared.Smartcards.Smartcard 物件：

名稱	描述
AssignedUserUuid	使用者的識別碼，表示指派智慧卡給此使用者。
Atr	目前正在初始化的卡片智慧卡重設回應 (ATR) 字串。
註解	描述智慧卡的註解。
Flags	描述智慧卡的旗標。
中介軟體	智慧卡的中介軟體。
ParentSmartcardUuid	此智慧卡已取代舊智慧卡的識別碼。
PermanentSmartcardUuid	智慧卡相關聯的永久智慧卡識別碼。
PrimarySmartcardUuid	主要智慧卡的識別碼。
ProfileTemplateUuid	設定檔範本的識別碼，包含控管智慧卡的原則和設定。
ProfileTemplateVersion	建立智慧卡設定檔時的設定檔範本的版本。
SerialNumber	智慧卡的序號。
狀態	智慧卡的狀態。
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 類別