Отмена, отмена или завершение запроса
Пометьте запрос управления сертификатами Microsoft Identity Manager (MIM) как завершенный, отмененный или отмененный.
Примечание
URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.
Запрос
| Метод | URL-адрес запроса |
|---|---|
| PUT | /CertificateManagement/api/v1.0/requests/{id} |
Параметры URL-адреса
| Свойство | Описание |
|---|---|
| идентификатор | Обязательный. Идентификатор GUID запроса, который необходимо выполнить. |
Заголовки запросов
Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст запроса
Текст запроса содержит следующие свойства:
| Свойство | Описание |
|---|---|
| status | Состояние, которое необходимо присвоить запросу. Возможные значения: "Завершено", "Отменено" или "Отброшено". |
Ответ
В этом разделе описывается ответ.
Коды ответов
| Код | Описание |
|---|---|
| 200 | ОК |
| 204 | Нет содержимого |
| 403 | Запрещено |
| 500 | Внутренняя ошибка |
Заголовки ответов
Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст ответа
При успешном выполнении возвращает объект Microsoft.Clm.Shared.Requests.Request . Объект описывает запрос MIM CM, помеченный как завершенный. Объект содержит следующие свойства:
| Имя | Описание |
|---|---|
| Комментарий | Комментарий, связанный с запросом MIM CM. |
| Завершено | Время завершения запроса MIM CM. |
| DataCollection | Элементы сбора данных, связанные с запросом MIM CM. |
| DataCollectionFlags | Параметры сбора данных для запроса MIM CM. |
| Флаги | Параметры, связанные с запросом 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
}