Criar pedido pam

Artigo
09/14/2023

Utilizado por uma conta com privilégios para elevar a uma função de PAM.

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
POST	/api/pamresources/pamrequests

Parâmetros de consulta

Parâmetro	Description
Justificação	Opcional. O motivo fornecido pelo utilizador para o pedido de elevação.
RoleId	Obrigatório. O identificador exclusivo (GUID) da função PAM para a qual elevar.
RequestedTTL	Obrigatório. O tempo de expiração pedido, em segundos.
RequestedTime	Opcional. O tempo para elevar privilégios.
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.

Nota

Pode especificar os parâmetros Justificação, RoleId, RequestedTTL e RequestedTime como propriedades no corpo do pedido, em vez de como parâmetros de consulta. O parâmetro v só pode ser especificado como um parâmetro de consulta.

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

Opcional. Os parâmetros Justificação, RoleId, RequestedTTL e RequestedTime podem ser especificados como propriedades de um corpo do pedido em vez de os especificar na cadeia de consulta de URL.

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 um objeto de pedido PAM com as seguintes propriedades:

Propriedade	Descrição
RequestID	O identificador exclusivo (GUID) para o pedido de PAM.
CreatorID	O identificador exclusivo (GUID) no serviço MIM da conta que criou o pedido.
Justificação	O motivo da elevação.
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.
RequestStatus	O estado do pedido. Os valores possíveis são "Processamento", "Ativo", "Fechado", "Fecho", "Expirado", "PendingApproval", "PendingMFA" e "Rejeitado".

Exemplo

Esta secção fornece exemplos para criar um pedido de PAM.

Exemplo: Pedido 1

POST /api/pamresources/pamrequests?Justification=Sample+Reason&RoleId=00000000-0000-0000-0000-000000000000&RequestedTTL=7200&RequestedTime=2015%2F07%2F11+23%3A40 HTTP/1.1

Exemplo: Resposta 1

HTTP/1.1 201 Created

{  
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests/@Element",
    "RequestId":"c0112f13-b16b-40ad-b547-07f23a7fba52",
    "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
    "Justification":"Sample Reason",
    "CreationTime":"2015-07-11T23:38:09.036164-07:00",
    "CreationMethod":"PAM Web API",
    "ExpirationTime":"0001-01-01T00:00:00",
    "RoleId":"00000000-0000-0000-0000-000000000000",
    "RequestedTTL":"7200",
    "RequestedTime":"2015-07-12T06:40:00Z",
    "RequestStatus":"PendingApproval"
}

Exemplo: Pedido 2

POST /api/pamresources/pamrequests?Justification=&RoleId=00000000-0000-0000-0000-000000000000&RequestedTTL=3600&RequestedTime= HTTP/1.1

Exemplo: Resposta 2

HTTP/1.1 201 Created

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests/@Element",
    "RequestId":"504f9c49-00db-42bd-a157-ee5664617189",
    "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
    "Justification":null,
    "CreationTime":"2015-07-11T23:07:30.2200123-07:00",
    "CreationMethod":"PAM Web API",
    "ExpirationTime":"0001-01-01T00:00:00",
    "RoleId":"00000000-0000-0000-0000-000000000000",
    "RequestedTTL":"3600",
    "RequestedTime":"2015-07-12T06:07:27.7229894Z",
    "RequestStatus":"PendingApproval"
}

Partilhar via