更新智能卡状态

项目
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 请求和响应标头。

请求正文

请求正文包含以下属性：

属性	说明
状态	将请求设置为的状态，例如“已停用”。

响应

本部分介绍响应。

响应代码

代码	说明
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 类