Запрос на создание

Статья
09/14/2023

Создайте запрос на управление сертификатами (CM) Microsoft Identity Manager (MIM).

Примечание

URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.

Запрос

Метод	URL-адрес запроса
POST	/CertificateManagement/api/v1.0/requests

Параметры URL-адреса

Нет.

Заголовки запросов

Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.

Текст запроса

Текст запроса содержит следующие свойства:

Свойство	Описание
profiletemplateuuid	Обязательный. Идентификатор GUID шаблона профиля, для которого пользователь создает запрос.
datacollection	Обязательный. Коллекция пар "имя-значение", представляющая данные, которые предоставляются регистрирующимся пользователем. Коллекцию необходимых данных можно извлечь из политики рабочего процесса шаблона профиля. Можно указать и пустую коллекцию.
target	Необязательный элемент. Идентификатор GUID целевого пользователя, для которого создается запрос. Если значение не указано, по умолчанию используется текущий пользователь.
тип	Обязательный элемент. Тип создаваемого запроса. Доступные типы запросов: "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryCards" и "Разблокировать". Примечание. Не все типы запросов поддерживаются во всех шаблонах профилей. Например, нельзя указать операцию разблокировки в шаблоне профиля программного обеспечения.
comment	Обязательный. Любые комментарии, которые может ввести пользователь. Политика рабочего процесса определяет, требуется ли свойство comment. Можно указать пустую строку.
priority	Необязательный элемент. Приоритет запроса. Если значение не указано, используется приоритет запроса по умолчанию, определяемый параметрами шаблона профиля.

Ответ

В этом разделе описывается ответ.

Коды ответов

Код	Описание
201	Создание
403	Запрещено
500	Внутренняя ошибка

Заголовки ответов

Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.

Текст ответа

В случае успешного выполнения возвращается URI созданного запроса.

Пример

В этом разделе приведен пример создания запросов регистрации и разблокировки.

Пример. Запрос 1

POST /CertificateManagement/api/v1.0/requests HTTP/1.1

{
    "datacollection":"[]",
    "type":"Enroll",
    "profiletemplateuuid":"a039b4d0-5ce8-4eff-8651-181c6576fda3",
    "comment":""
}

Пример: ответ 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":""
}

Пример: ответ 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"
}

Поделиться через