Partilhar via


Obter solicitações PAM

Usado por uma conta privilegiada para retornar um histórico de solicitações PAM postadas anteriormente.

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 do Pedido
GET /api/pamresources/pamrequests

Parâmetros de consulta

Parâmetro Descrição
$filter Opcional. Especifique qualquer uma das propriedades de solicitação PAM em uma expressão de filtro para retornar uma lista filtrada de respostas. Para obter mais informações sobre operadores suportados, consulte Filtragem de em detalhes do serviço PAM REST API.
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 Versionamento em Detalhes do serviço PAM REST API.

Cabeçalhos da requisição

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

Corpo de solicitação

Nenhum.

Resposta

Esta seção descreve a resposta.

Código 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 solicitação comuns, consulte cabeçalhos de solicitação e resposta HTTP em detalhes do serviço PAM REST API.

Corpo da resposta

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

Propriedade Descrição
ID do Pedido O identificador exclusivo (GUID) para a solicitação PAM.
ID do criador Um identificador exclusivo (GUID) para a conta do Ative Directory que criou a solicitação PAM.
Justificação A razão para a elevação.
Nome de Exibição O nome de exibição da solicitação PAM no MIM.
CreationTime O tempo de criação do pedido.
CriaçãoMétodo O método usado para criar a solicitação.
ExpirationTime O tempo de expiração do pedido.
ID da Função O identificador exclusivo (GUID) da função PAM.
SolicitadoTTL O tempo limite de expiração solicitado em segundos.
Tempo Solicitado O tempo solicitado para elevação.
RequestedStatus O estado da fatura. Os valores possíveis são "Ativo", "Fechado", "Fechamento", "Expirado", "Aprovação Pendente" e "Rejeitado".

Exemplo

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

Exemplo: Pedido

GET /api/pamresources/pamrequests?$filter=CreationTime%20gt%20datetime'2015-06-12T04:49:32.431Z'%20and%20CreationTime%20lt%20datetime'2015-07-13T04:49:32.432Z' HTTP/1.1

Exemplo: Resposta

HTTP/1.1 200 OK

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests",
    "value":[
        {
            "RequestId":"b22e1343-9a2b-4e33-a70a-1bb7b2d405b9",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":null,
            "CreationTime":"2015-06-23T11:34:38.58Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-06-23T12:34:38.847Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-06-23T11:34:36.417Z",
            "RequestStatus":"Expired"
        },
        {
            "RequestId":"3a98d1c7-524d-4b72-9da7-bd9f907eab55",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"Reason for Request",
            "CreationTime":"2015-07-12T04:35:14.433Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-07-12T04:43:51.95Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"12960000",
            "RequestedTime":"2015-07-12T04:35:00Z",
            "RequestStatus":"Closed"
        },
        {
            "RequestId":"f5e80be1-e9a3-42c4-81f8-4be5a4a429f4",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":null,
            "CreationTime":"2015-07-12T04:48:17.46Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-07-12T05:48:17.853Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-07-12T04:48:14.057Z",
            "RequestStatus":"Active"
        },
        {
            "RequestId":"b0f0ddc0-c809-4770-9d39-0d706f97a2de",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"",
            "CreationTime":"2015-06-30T07:01:13.147Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"0001-01-01T00:00:00",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-06-30T07:01:13.119Z",
            "RequestStatus":"Rejected"
        },
        {
            "RequestId":"5ec10e61-cdd1-404e-a18e-740467d87dbf",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"Example Reason",
            "CreationTime":"2015-07-12T04:49:09.963Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"0001-01-01T00:00:00",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"12960000",
            "RequestedTime":"2015-07-12T04:50:00Z",
            "RequestStatus":"PendingApproval"
        }
    ]
}