Получение ожидающих запросов PAM

Статья
03/22/2025

Используется привилегированной учетной записью для возврата списка ожидающих запросов, которым требуется утверждение.

Примечание.

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

Просьба

Метод	URL-адрес запроса
ПОЛУЧАЙ	/api/pamresources/pamrequeststoapprove

Параметры запроса

Параметр	Описание
$фильтр	Необязательно. Укажите любой из ожидающих свойств запроса PAM в выражении фильтра, чтобы вернуть отфильтрованный список ответов. Дополнительные сведения о поддерживаемых операторах см. в фильтрации в службе REST API PAM.
v	Необязательно. Версия API. Если он не включен, используется текущая (последняя выпущенная) версия API. Дополнительные сведения см. в разделе Управление версиями в службе REST API PAM.

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

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

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

Нет.

Ответ

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

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

Код	Описание
200	ХОРОШО
401	Не авторизовано
403	Запрещено
408	Истекло время ожидания запроса
500	Внутренняя ошибка сервера
503	Служба недоступна

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

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

Основная часть ответа

Успешный ответ содержит список объектов утверждения запроса PAM со следующими свойствами:

Недвижимость	Описание
RoleName	Отображаемое имя роли, для которой требуется утверждение.
Заявитель	Имя пользователя запрашивающего участника, который будет утвержден.
Оправдание	Обоснование, предоставленное пользователем.
Запрошенный срок жизни	Запрошенный срок действия в секундах.
Запрошенное время	Запрошенное время для повышения прав.
Время создания	Время создания запроса.
FIMRequestID	Содержит один элемент Value с уникальным идентификатором (GUID) запроса PAM.
RequestorID	Содержит один элемент Value с уникальным идентификатором (GUID) для учетной записи Active Directory, создающей запрос PAM.
УтверждениеObjectID	Содержит один элемент Value с уникальным идентификатором (GUID) для объекта утверждения.

Пример

В этом разделе приведен пример получения ожидающих запросов PAM.

Пример: запрос

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

Пример: ответ

HTTP/1.1 200 OK

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequeststoapprove",
    "value":[
        {
            "RoleName":"ApprovalRole",
            "Requestor":"PRIV.Jen",
            "Justification":"Justification Reason",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-07-11T22:25:00Z",
            "CreationTime":"2015-07-11T22:24:52.51Z",
            "FIMRequestID":{
                "Value":"9802d7b7-b4e9-4fe4-8f5c-649cda127e49"
            },
            "RequestorID":{
                "Value":"73257e5e-00b3-4309-a330-f1e607ff113a"
            },
            "ApprovalObjectID":{
                "Value":"5dbd9d0c-0a9d-4f75-8cbd-ff6ffdc00143"
            }
        }
    ]
}

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