更新智慧卡狀態

發行項
09/14/2023

更新智慧卡的狀態。

注意

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

要求

方法	要求 URL
GET	/CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

URL 參數

參數	描述
reqid	必要。 MICROSOFT IDENTITY MANAGER (MIM 的特定要求識別碼，) 憑證管理 (CM) 。
scid	必要。 MIM CM 專屬的智慧卡識別碼。此值會對應至 Microsoft.Clm.Shared.Smartcards.Smartcard 物件中的「uuid」欄位。

要求標頭

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

要求本文

要求本文包含下列屬性：

屬性	描述
status	要設定要求的狀態，例如「已淘汰」。

回應

本節說明回應。

回應碼

程式碼	描述
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	智慧卡設定檔的識別碼。

範例

本節提供更新智慧卡狀態的範例。

範例：要求

PUT /certificatemanagement/api/v1.0/requests/b105403d-d021-41ea-9f11-be3d677d229e/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

範例：回應

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":6,
    "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 類別