Obter pedidos de PAM

Artigo
09/14/2023

Utilizado por uma conta com privilégios para devolver um histórico de pedidos de PAM publicados anteriormente.

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/pamrequests

Parâmetros de consulta

Parâmetro	Description
$filter	Opcional. Especifique qualquer uma das propriedades do pedido PAM numa expressão de filtro para devolver uma lista filtrada de respostas. Para obter mais informações sobre os operadores suportados, veja Filtragem nos detalhes do serviço da 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 Os detalhes do serviço de API REST de PAM no controlo de versões.

Cabeçalhos do pedido

Para ver os cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos HTTP e resposta nos detalhes do serviço da 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 ver os cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos HTTP e resposta nos detalhes do serviço da API REST de PAM.

Corpo da resposta

Uma resposta bem-sucedida contém uma lista de objetos de pedido pam com as seguintes propriedades:

Propriedade	Descrição
RequestID	O identificador exclusivo (GUID) para o pedido de PAM.
CreatorID	Um identificador exclusivo (GUID) para a conta do Active Directory que criou o pedido pam.
Justificação	O motivo da elevação.
DisplayName	O nome a apresentar do pedido PAM no MIM.
HoraDaCriação	A hora de criação do pedido.
CreationMethod	O método utilizado para criar o pedido.
ExpirationTime	O tempo de expiração do pedido.
RoleID	O identificador exclusivo (GUID) da função PAM.
RequestedTTL	O tempo limite de expiração pedido em segundos.
RequestedTime	O tempo pedido para a elevação.
RequestedStatus	O estado do pedido. Os valores possíveis são "Ativo", "Fechado", "Fechar", "Expirado", "PendingApproval" e "Rejeitado".

Exemplo

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

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

Partilhar via