更新智能卡状态

更新智能卡的状态。

注释

本文中的 URL 相对于 API 部署期间选择的主机名,例如 https://api.contoso.com

请求

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

URL 参数

参数 说明
reqid 必填。 特定于Microsoft标识管理器(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"
}

另请参阅