取消、放弃或完成请求

项目
09/14/2023

将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 请求和响应标头。

请求正文

请求正文包含以下属性：

属性	说明
状态	要设置的请求状态。可能的值为“Completed”、“Canceled”或“Abandoned”。

响应

本部分介绍响应。

响应代码

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

响应标头

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

响应正文

成功后，返回 Microsoft.Clm.Shared.Requests.Request 对象。对象描述已标记为已完成的 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
}

通过