创建请求

项目
09/14/2023

创建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"
}

通过