Запрос Get
Возвращает один или несколько указанных Microsoft Identity Manager (MIM) запросов управления сертификатами (CM).
Примечание
URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.
Запрос
| Метод | URL-адрес запроса |
|---|---|
| GET | /CertificateManagement/api/v1.0/requests/{id} |
Параметры URL-адреса
| Свойство | Описание |
|---|---|
| идентификатор | Необязательный элемент. Глобальный уникальный идентификатор (GUID) запроса, который необходимо извлечь. |
Параметры запроса
| Свойство | Описание |
|---|---|
| targetuser | Необязательный элемент. Целевой пользователь запроса. Если целевой объект не указан, возвращаются все запросы, независимо от целевого пользователя. Примечание. В настоящее время поддерживается только значение current. |
| status | Необязательный элемент. Указывает состояние запроса, который нужно извлечь. Возможные типы состояний: "Утверждено", "Отменено", "Завершено", "Отказано", "Выполнение", "Сбой", "Нет" и "Ожидание". Если состояние не указано, возвращаются все запросы, независимо от состояния. |
Заголовки запросов
Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст запроса
Нет.
Ответ
В этом разделе описывается ответ.
Коды ответов
| Код | Описание |
|---|---|
| 200 | ОК |
| 204 | Нет содержимого |
| 403 | Запрещено |
| 500 | Внутренняя ошибка |
Заголовки ответов
Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API 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. |
Пример
В этом разделе приведен пример получения указанных запросов MIM CM.
Пример. Запрос 1
GET /certificatemanagement/api/v1.0/requests/a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099 HTTP/1.1
Пример: ответ 1
HTTP/1.1 200 OK
{
"Uuid":"a9b4b42c-cc50-4c9b-89d1-bbc0bcd5a099",
"RequestType":1,
"Status":3,
"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":"0001-01-01T00:00:00",
"NewProfileUuid":"00000000-0000-0000-0000-000000000000",
"OldProfileUuid":"00000000-0000-0000-0000-000000000000",
"NewSmartcardUuid":"00000000-0000-0000-0000-000000000000",
"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
}
Пример: запрос 2
GET /certificatemanagement/api/v1.0/requests/0c96d73f-967b-420e-854a-43ad2a1504bc HTTP/1.1
Пример. Ответ 2
HTTP/1.1 200 OK
{
"Uuid":"0c96d73f-967b-420e-854a-43ad2a1504bc",
"RequestType":5,
"Status":3,
"Flags":2,
"DataCollection":[
{
"Name":"Sample Data Item",
"Value":null
}
],
"DataCollectionFlags":32,
"OriginatorUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"TargetUserUuid":"8f1590dc-d932-4b66-8e68-2e91c5880780",
"Submitted":"2015-07-07T23:40:33.133Z",
"Completed":"0001-01-01T00:00:00",
"NewProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"OldProfileUuid":"b99ff38c-6653-471f-ae3c-325bb351a6bc",
"NewSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"OldSmartcardUuid":"17cf063d-e337-4aa9-a822-346554ddd3c9",
"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;;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",
"IsSmartcard":true,
"IsEnrollmentAgent":false,
"IsDataCollectionComplete":false
}