更新智能卡状态

更新智能卡的状态。

注意

本文中的 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 中的 HTTP 请求和响应标头REST API 服务详细信息

请求正文

请求正文包含以下属性:

属性 说明
status 要设置请求的状态,例如"已停用"。

响应

本部分介绍响应。

响应代码

代码 说明
200 确定
204 无内容
403 禁止
500 内部错误

响应头

有关常见响应标头,请参阅CM 中的 HTTP 请求和响应标头REST API服务详细信息

响应正文

成功时,将返回一个 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"
}

另请参阅