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

Статья
09/14/2023

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

Примечание

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

Запрос

Метод	URL-адрес запроса
GET	/api/pamresources/pamrequeststoapprove

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

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

Параметр

Описание

$filter

Необязательный элемент. Укажите любое из ожидающих свойств запроса PAM в выражении фильтра, чтобы вернуть отфильтрованный список ответов. Дополнительные сведения о поддерживаемых операторах см. в разделе Фильтрация в сведениях о службе REST API PAM.

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

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

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

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

Нет.

Ответ

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

Коды ответов

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

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

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

Текст ответа

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

Свойство	Описание
RoleName	Отображаемое имя роли, для которого требуется утверждение.
Requestor	Имя пользователя, инициирующего запрос, который требуется утвердить.
Обоснование	Обоснование, предоставленное пользователем.
RequestedTTL	Запрошенный срок действия в секундах.
RequestedTime	Запрошенное время повышения прав.
CreationTime	Время создания запроса.
FIMRequestID	Содержит один элемент Value с уникальным идентификатором (GUID) запроса PAM.
RequestorID	Содержит один элемент Value с уникальным идентификатором (GUID) для учетной записи Active Directory, создающей запрос PAM.
ApprovalObjectID	Содержит один элемент 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"
            }
        }
    ]
}

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