获取智能卡配置文件

项目
09/14/2023

获取用户的智能卡配置文件列表。该列表包括当前用户可执行的可能操作。然后可以为任何指定操作启动某项请求。

注意

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

请求

方法	请求 URL
GET	/CertificateManagement/api/v1.0/smartcards /CertificateManagement/api/v1.0/smartcards/{smartcarduuid}

URL 参数

属性	说明
smartcarduuid	可选。 Microsoft Identity Manager (MIM 表示的智能卡 UUID) 证书管理 (CM) 。该值对应于 Microsoft.Clm.Shared.Smartcards.Smartcard 对象中的“uuid”字段。

查询参数

属性	说明
cardid	可选。 MIM CM 表示的智能卡 UUID。该值对应于 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	智能卡配置文件的标识符。

示例

本部分提供获取用户智能卡配置文件的示例。

示例：请求 1

GET /certificatemanagement/api/v1.0/smartcards?cardid=d1ef6869-5517-42a0-8f05-16ca1a0b834d HTTP/1.1

示例：响应 1

HTTP/1.1 200 OK

{
    "Uuid":"438d1b30-f3b4-4bed-85fa-285e08605ba7",
    "Status":3,
    "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":"{d1ef6869-5517-42a0-8f05-16ca1a0b834d}",
    "Middleware":"MSBaseCSP",
    "Atr":"3b8d0180fba000000397425446590301c8"
}

示例：请求 2

GET /certificatemanagement/api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9 HTTP/1.1

示例：响应 2

HTTP/1.1 200 OK

{
    "Uuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "Status":2,
    "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 类

通过