Receber pedidos de PAM pendentes

Usado por uma conta privilegiada para devolver uma lista de pedidos pendentes que precisam de aprovação.

Nota

Os URLs deste artigo são relativos ao nome de anfitrião escolhido durante a implantação da API, tais como https://api.contoso.com .

Pedir

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

Parâmetros de consulta

Parâmetro Descrição
$filter Opcional. Especifique qualquer uma das propriedades de pedido pam pendentes numa expressão de filtro para devolver uma lista filtrada de respostas. Para obter mais informações sobre operadores apoiados, consulte a filtragem nos dados do serviço API PAM REST.
v Opcional. A versão API. Se não estiver incluída, utiliza-se a versão atual (mais recentemente lançada) da API. Para mais informações, consulte a versão em detalhes do serviço API PAM REST.

Cabeçalhos do pedido

Para cabeçalhos de pedido comuns, consulte os cabeçalhos de pedidos HTTP e cabeçalhos de resposta nos dados do serviço API PAM REST.

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 interno do servidor
503 Serviço Indisponível

Cabeçalhos de resposta

Para cabeçalhos de pedido comuns, consulte os cabeçalhos de pedidos HTTP e cabeçalhos de resposta nos dados do serviço API PAM REST.

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 de exibição da função para a qual é necessária a aprovação.
Requerente O nome de utilizador do solicitador a aprovar.
Justificação A justificação fornecida pelo utilizador.
SolicitadoTTL O tempo de validade solicitado em segundos.
Hora Solicitada O tempo solicitado para a elevação.
HoraDaCriação O tempo de criação do pedido.
FIMRequestID Contém um único elemento, "Value", com o identificador único (GUID) do pedido PAM.
RequestorID Contém um único elemento, "Valor", com o identificador único (GUID) para a conta Ative Directory que criou o pedido DE PAM.
AprovaçãoObjectID Contém um único elemento, "Value", com o identificador único (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"
            }
        }
    ]
}