将智能卡分配给请求
将指定的智能卡绑定到指定的请求。 绑定智能卡后,只能使用指定的卡执行请求。
注意
本文中的 URL 相对于在 API 部署期间选择的主机名,例如 https://api.contoso.com
。
请求
方法 | 请求 URL |
---|---|
POST | /CertificateManagement/api/v1.0/smartcards |
URL 参数
无。
请求标头
有关常见请求标头,请参阅 CM REST API 服务详细信息中的 HTTP 请求和响应标头。
请求正文
请求正文包含以下属性:
属性 | 说明 |
---|---|
requestid | 要绑定到智能卡的请求的 ID。 |
cardid | 智能卡的 cardid。 |
atr | 智能卡复位应答 (ATR) 字符串。 |
响应
本部分介绍响应。
响应代码
代码 | 说明 |
---|---|
201 | 创建 |
204 | 无内容 |
403 | 禁止 |
500 | 内部错误 |
响应标头
有关常见响应标头,请参阅 CM REST API 服务详细信息中的 HTTP 请求和响应标头。
响应正文
如果成功,将返回新建的智能卡对象的 URI。
示例
本部分提供绑定智能卡的示例。
示例:请求
POST /CertificateManagement/api/v1.0/smartcards HTTP/1.1
{
"requestid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"cardid":"bc88f13f-83ba-4037-8262-46eba1291c6e",
"atr":"3b8d0180fba000000397425446590301c8"
}
示例:响应
HTTP/1.1 201 Created
"api/v1.0/smartcards/17cf063d-e337-4aa9-a822-346554ddd3c9"