Obter pedidos de PAM pendentes

Artigo
09/14/2023

Utilizado por uma conta com privilégios para devolver uma lista de pedidos pendentes que precisam de aprovação.

Nota

Os URLs neste artigo são relativos ao nome do anfitrião escolhido durante a implementação da API, como https://api.contoso.com.

Pedir

Método	URL do Pedido
GET	/api/pamresources/pamrequeststoapprove

Parâmetros de consulta

Parâmetro	Description
$filter	Opcional. Especifique qualquer uma das propriedades do pedido PAM pendente numa expressão de filtro para devolver uma lista filtrada de respostas. Para obter mais informações sobre os operadores suportados, veja Filtering in PAM REST API service details (Filtrar nos detalhes do serviço API REST de PAM).
v	Opcional. A versão da API. Se não estiver incluída, é utilizada a versão atual (lançada mais recentemente) da API. Para obter mais informações, veja Versioning in PAM REST API service details (Controlo de versões no serviço API REST de PAM).

Cabeçalhos do pedido

Para obter cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço API REST de PAM.

Corpo do pedido

Nenhum.

Resposta

Esta secção descreve a resposta.

Códigos de resposta

Código	Descrição
200	OK
401	Não autorizado
403	Proibido
408	Tempo Limite do Pedido
500	Erro de Servidor Interno
503	Serviço Indisponível

Cabeçalhos de resposta

Para obter cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço API REST de PAM.

Corpo da resposta

Uma resposta bem-sucedida contém uma lista de objetos de aprovação de pedidos de PAM com as seguintes propriedades:

Propriedade	Descrição
RoleName	O nome a apresentar da função para a qual a aprovação é necessária.
Requerente	O nome de utilizador do requerente a ser aprovado.
Justificação	A justificação fornecida pelo utilizador.
RequestedTTL	O tempo de expiração pedido em segundos.
RequestedTime	O tempo pedido para a elevação.
HoraDaCriação	A hora de criação do pedido.
FIMRequestID	Contém um único elemento, "Valor", com o identificador exclusivo (GUID) do pedido de PAM.
RequestorID	Contém um único elemento, "Valor", com o identificador exclusivo (GUID) da conta do Active Directory que criou o pedido de PAM.
ApprovalObjectID	Contém um único elemento, "Valor", com o identificador exclusivo (GUID) para o Objeto de Aprovação.

Exemplo

Esta secção fornece um exemplo para obter os pedidos de PAM pendentes.

Exemplo: Pedido

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

Exemplo: Resposta

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"
            }
        }
    ]
}

Partilhar via