Obter pedidos de PAM pendentes

  • Artigo

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