Compartilhar via

Criar solicitação pam

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

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 da solicitação
PUBLICAR /api/pamresources/pamrequests

Parâmetros de consulta

Parâmetro Descrição
Justificativa Opcional. O motivo fornecido pelo usuário para a solicitação de elevação.
RoleId Obrigatório O GUID (identificador exclusivo) da função PAM para a qual elevar.
RequestedTTL Obrigatório O tempo de expiração solicitado, em segundos.
RequestedTime Opcional. O tempo para elevar privilégios.
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 Controle de versão nos detalhes do serviço da API REST do PAM.

Observação

Você pode especificar os parâmetros Justification, RoleId, RequestedTTLe RequestedTime como propriedades no corpo da solicitação e não como parâmetros de consulta. O parâmetro v só pode ser especificado como um parâmetro de consulta.

Cabeçalhos de solicitação

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

Corpo da solicitação

Opcional. Os parâmetros Justification, RoleId, RequestedTTLe RequestedTime podem ser especificados como propriedades de um corpo de solicitação em vez de especificá-los na cadeia de caracteres de consulta de URL.

Resposta

Esta seção descreve a resposta.

Códigos de resposta

Código Descrição
200 OKEY
401 Desautorizado
403 Proibido
408 Tempo Limite da Solicitação
500 Erro interno do servidor
503 Serviço indisponível

Cabeçalhos de resposta

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

Corpo da resposta

Uma resposta bem-sucedida contém um objeto de solicitação PAM com as seguintes propriedades:

Propriedade Descrição
RequestID O GUID (identificador exclusivo) para a solicitação pam.
CreatorID O GUID (identificador exclusivo) no serviço MIM para a conta que criou a solicitação.
Justificativa O motivo da elevação.
CreationTime A hora de criação da solicitação.
CreationMethod O método usado para criar a solicitação.
ExpirationTime A hora de expiração da solicitação.
RoleID O GUID (identificador exclusivo) da função PAM.
RequestedTTL O tempo limite de expiração solicitado em segundos.
RequestedTime O tempo solicitado para elevação.
RequestStatus O status da solicitação. Os valores possíveis são "Processamento", "Ativo", "Fechado", "Fechamento", "Expirado", "PendingApproval", "PendingMFA" e "Rejeitado".

Exemplo

Esta seção fornece exemplos para criar uma solicitação PAM.

Exemplo: Solicitação 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: Solicitação 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"
}
  • Last updated on