Criar pedido pam

  • Artigo

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=c28eab4a-95cf-4c08-a153-d5e8a9e660cd&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":"c28eab4a-95cf-4c08-a153-d5e8a9e660cd",
    "RequestedTTL":"7200",
    "RequestedTime":"2015-07-12T06:40:00Z",
    "RequestStatus":"PendingApproval"
}

Exemplo: Pedido 2

POST /api/pamresources/pamrequests?Justification=&RoleId=c28eab4a-95cf-4c08-a153-d5e8a9e660cd&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":"c28eab4a-95cf-4c08-a153-d5e8a9e660cd",
    "RequestedTTL":"3600",
    "RequestedTime":"2015-07-12T06:07:27.7229894Z",
    "RequestStatus":"PendingApproval"
}