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

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

Примечание.

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

Просьба

Метод URL-адрес запроса
ПОСТ /CertificateManagement/api/v1.0/requests

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

Нет.

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

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

Основное содержание запроса

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

Недвижимость Описание
profiletemplateuuid Обязательное. GUID шаблона профиля, для который пользователь создает запрос.
datacollection Обязательное. Коллекция пар "имя-значение", представляющая данные, предоставляемые регистрацией. Сбор необходимых данных, которые необходимо предоставить, можно получить из политики рабочего процесса шаблона профиля. Можно указать пустую коллекцию.
цель Необязательно. GUID целевого пользователя, для которому требуется создать запрос. Если он не указан, целевой объект по умолчанию используется для текущего пользователя.
тип Обязательное. Тип создаваемого запроса. Доступные типы запросов включают "Регистрация", "Дубликаты", "АвтономныйUnblock", "OnlineUpdate", "Продление", "Восстановление", "Восстановление", "Восстановить", "Восстановить", "Отменить", "Отменить", "Временные карты" и "Разблокировать".

примечание. Не все типы запросов поддерживаются во всех шаблонах профилей. Например, нельзя указать операцию разблокировки в шаблоне профиля программного обеспечения.
Комментарий Обязательное. Любые комментарии, которые могут быть введены пользователем. Политика рабочего процесса определяет, требуется ли свойство комментария. Можно указать пустую строку.
приоритет Необязательно. Приоритет запроса. Если этот параметр не указан, используется приоритет запроса по умолчанию, определенный параметрами шаблона профиля.

Ответ

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

Коды откликов

Код Описание
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"
}

См. также

  • Last updated on