创建请求

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

注意

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

请求

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

URL 参数

无。

请求标头

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

请求正文

请求正文包含以下属性:

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

注意:并非所有的请求类型在所有配置文件模板上都受支持。 例如,不能在软件配置文件模板上指定解除阻止操作。
comment 必需。 可能由用户输入的任何注释。 工作流策略定义 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":""
}

示例: Response 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":""
}

示例: Response 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"
}

另请参阅