共用方式為

更新智慧卡狀態

  • 發行項

更新智慧卡的狀態。

備註

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

請求

方法 請求 URL
獲取 /CertificateManagement/api/v1.0/requests/{reqid}/smartcards/{scid}

URL 參數

參數 說明
reqid 必須的。 Microsoft Identity Manager （MIM） 憑證管理 （CM） 特有的要求標識符。
scid 必須的。 MIM CM 特有的智慧卡識別碼。 值會對應至 Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard 物件中的 “uuid” 字段。

請求標頭

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

請求主體

要求本文包含下列屬性：

財產 說明
地位 要設定要求的狀態，例如「已淘汰」。

回應

本節描述回應。

回應碼

程式碼 說明
200 還行
204 沒有內容
403 禁止
500 內部錯誤

回應標頭

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

回應主體

成功時，傳回具有下列屬性的 JSON-Serialized Microsoft.Clm.Shared.Smartcards.Smartcards.Smartcard 物件：

名稱 說明
AssignedUserUuid 指派智慧卡之使用者的標識碼。
Atr 目前正在初始化之卡片的智慧卡回應重設 （ATR） 字串。
評論 描述智慧卡的批注。
標誌 描述智慧卡的旗標。
中間件 智慧卡的中間件。
ParentSmartcardUuid 智慧卡已取代之舊智慧卡的標識碼。
PermanentSmartcardUuid 與智慧卡相關聯的永久智慧卡標識碼。
PrimarySmartcardUuid 主要智慧卡的標識碼。
ProfileTemplateUuid 配置文件範本的標識碼，其中包含控管智慧卡的原則和設定。
ProfileTemplateVersion 建立智慧卡配置檔時配置檔範本的版本。
序號 智慧卡的序號。
地位 智慧卡的狀態。
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"
}

另請參閱