更新智慧卡狀態

更新智慧卡的狀態。

注意

本文中的 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 特定的智慧卡識別碼。 此值會對應至 Clm 中的 "uuid" 欄位。

要求標頭

關於常見的要求標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭

要求本文

要求主體包含下列屬性:

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

回應

本節說明回應。

回應碼

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

回應標頭

關於常見的回應標頭,請參閱CM REST API 服務詳細資料中的HTTP 要求和回應標頭

回應本文

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

Name 描述
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"
}

另請參閱