Compartilhar via

Obter solicitações pendentes do PAM

Usado por uma conta com privilégios para retornar uma lista de solicitações pendentes que precisam de aprovação.

Observação

As URLs neste artigo são relativas ao nome do host escolhido durante a implantação da API, como https://api.contoso.com.

Solicitação

Método URL da solicitação
Conseguir /api/pamresources/pamrequeststoapprove

Parâmetros de consulta

Parâmetro Descrição
$filter Opcional. Especifique qualquer uma das propriedades de solicitação do PAM pendentes em uma expressão de filtro para retornar uma lista filtrada de respostas. Para obter mais informações sobre operadores com suporte, consulte Filtragem nos detalhes do serviço da API REST do PAM.
v Opcional. A versão da API. Se não estiver incluída, a versão atual (lançada mais recentemente) da API será usada. Para obter mais informações, consulte Controle de versão nos detalhes do serviço da API REST do PAM.

Cabeçalhos de solicitação

Para obter cabeçalhos de solicitação comuns, consulte cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do PAM .

Corpo da solicitação

Nenhum.

Resposta

Esta seção descreve a resposta.

Códigos de resposta

Código Descrição
200 OKEY
401 Desautorizado
403 Proibido
408 Tempo Limite da Solicitação
500 Erro interno do servidor
503 Serviço indisponível

Cabeçalhos de resposta

Para obter cabeçalhos de solicitação comuns, consulte cabeçalhos de solicitação e resposta HTTP nos detalhes do serviço da API REST do PAM .

Corpo da resposta

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

Propriedade Descrição
RoleName O nome de exibição da função para a qual a aprovação é necessária.
Requestor O nome de usuário do solicitante a ser aprovado.
Justificativa A justificativa fornecida pelo usuário.
RequestedTTL O tempo de expiração solicitado em segundos.
RequestedTime O tempo solicitado para elevação.
CreationTime A hora de criação da solicitação.
FIMRequestID Contém um único elemento, "Value", com o identificador exclusivo (GUID) da solicitação PAM.
RequestorID Contém um único elemento, "Value", com o GUID (identificador exclusivo) para a conta do Active Directory que criou a solicitação PAM.
ApprovalObjectID Contém um único elemento, "Value", com o GUID (identificador exclusivo) para o Objeto de Aprovação.

Exemplo

Esta seção fornece um exemplo para obter as solicitações pendentes do PAM.

Exemplo: Solicitação

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"
            }
        }
    ]
}
  • Last updated on