取消、放弃或完成请求

将 Microsoft Identity Manager (MIM) 证书管理 (CM) 请求标记为已完成、已取消或已放弃。

注意

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

请求

方法 请求 URL
PUT /CertificateManagement/api/v1.0/requests/{id}

URL 参数

属性 说明
id 必需。 完成请求的 GUID。

请求标头

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

请求正文

请求正文包含以下属性:

属性 说明
status 要设置的请求状态。 可能的值为 "已完成"、"已取消" 或 "已放弃"。

响应

本部分介绍响应。

响应代码

代码 说明
200 确定
204 无内容
403 禁止
500 内部错误

响应头

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

响应正文

成功后,将返回一个 Clm 对象。 对象描述已标记为已完成的 MIM CM 请求。 对象包含以下属性:

“属性” 说明
注释 与 MIM CM 请求关联的注释。
已完成 完成 MIM CM 请求的时间。
DataCollection 与 MIM CM 请求关联的数据收集项。
DataCollectionFlags MIM CM 请求的数据收集选项。
Flags 与 MIM CM 请求关联的选项。
IsDataCollectionComplete 指示 MIM CM 请求的数据收集是否已完成的布尔值。
IsEnrollmentAgent 指示运行 MIM CM 请求是否需要注册代理的布尔值。
IsSmartcard 指示 MIM CM 请求是智能卡请求还是软件配置文件请求的布尔值。
NewProfileUuid 由 MIM CM 请求生成的新软件配置文件标识。
NewSmartcardUuid 由 MIM CM 请求分配的新智能卡标识。
OldProfileUuid 为其创建 MIM CM 请求的软件配置文件标识。
OldSmartcardUuid 为其创建 MIM CM 请求的智能卡标识。
OriginatorUserUuid 发起 MIM CM 请求的用户的标识。
优先级 MIM CM 请求的优先级。
ProfileTemplateUuid 为其创建 MIM CM 请求的配置文件模板标识。
RequestType MIM CM 请求类型。
SecurityDescriptor MIM CM 请求的安全描述符。
状态 MIM CM 请求的状态。
已提交 MIM CM 请求提交的时间。
TargetUserUuid MIM CM 请求的目标用户标识。
Uuid MIM CM 请求的标识符。

示例

本部分提供将请求标记为已完成的示例。

示例:请求

PUT /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1


{
    "status":"Completed"
}

示例:响应

HTTP/1.1 200 OK

{
    "Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
    "RequestType":1,
    "Status":8,
    "Flags":2,
    "DataCollection":[

    ],
    "DataCollectionFlags":32,
    "OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
    "Submitted":"2015-07-07T23:36:21.93Z",
    "Completed":"2015-07-07T23:37:37.767Z",
    "NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
    "OldProfileUuid":"00000000-0000-0000-0000-000000000000",
    "NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
    "OldSmartcardUuid":"00000000-0000-0000-0000-000000000000",
    "Priority":0,
    "Comment":"",
    "ProfileTemplateUuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "SecurityDescriptor":"O:S-1-5-21-2127521184-1604012920-1887927527-14134865D:(D;;LC;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5094534)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-5219125)(A;;SWRC;;;S-1-5-21-2127521184-1604012920-1887927527-5094533)(A;;RC;;;WD)(A;;CCDCLCSWSDRC;;;S-1-5-21-2127521184-1604012920-1887927527-14134865)(A;;DCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)(A;;CCDCSW;;;S-1-5-21-2127521184-1604012920-1887927527-14995557)\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
    "IsSmartcard":true,
    "IsEnrollmentAgent":false,
    "IsDataCollectionComplete":false
}

另请参阅