创建请求

  • 项目

创建Microsoft Identity Manager (MIM) 证书管理 (CM) 请求。

注意

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

请求

方法 请求 URL
POST /CertificateManagement/api/v1.0/requests

URL 参数

无。

请求标头

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

请求正文

请求正文包含以下属性：

属性 说明
profiletemplateuuid 必需。 用户为其创建请求的配置文件模板的 GUID。
datacollection 必需。 名称-值对的集合，表示由登记者提供的数据。 必须提供的必要数据的集合可以从配置文件模板的工作流策略检索。 可以指定空集。
目标 可选。 要为其创建请求的目标用户的 GUID。 如果未指定，则目标默认为当前用户。
类型 必需。 正在创建的请求的类型。 可用的请求类型包括“注册”、“重复”、“脱机Unblock”、“OnlineUpdate”、“续订”、“恢复”、“恢复”、“恢复”、“恢复”、“停用”、“撤销”、“临时卡”和“取消阻止”。

注意：并非所有请求类型都支持所有配置文件模板。 例如，不能在软件配置文件模板上指定取消阻止操作。
comment 必需。 可能由用户输入的任何注释。 工作流策略定义注释属性是否是必需的。 可以指定一个空字符串。
priority 可选。 请求的优先级。 如果未指定，则使用配置文件模板设置确定的默认请求优先级。

响应

本部分介绍响应。

响应代码

代码 说明
201 创建
403 禁止
500 内部错误

响应标头

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

响应正文

成功时，返回新创建的请求的 URI。

示例

本部分提供创建注册和取消阻止请求的示例。

示例：请求 1

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "datacollection":"[]",
    "type":"Enroll",
    "profiletemplateuuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "comment":""
}

示例：响应 1

HTTP/1.1 201 Created

"api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099"

示例：请求 2

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{  
    "datacollection":"[]",
    "type":"Unblock",
    "smartcard":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "comment":""
}

示例：响应 2

HTTP/1.1 201 Created

"api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc"

示例：请求 3

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "profiletemplateuuid" : "97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1",
    "datacollection":
    [
        {"name" : "pavle"},
        {"city" : "seattle"}
    ],
    "target" : "97CC3493-F556-4C9B-9D8B-982434201527",
    "type" : "Enroll",
    "comment" : "LALALALA",
    "priority" :  "4"
}

另请参阅