Criar solicitação pam

Artigo
09/14/2023

Usado por uma conta com privilégios para elevar a uma função do 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
POST	/api/pamresources/pamrequests

Parâmetros de consulta

Parâmetro	Descrição
Justificativa	Opcional. O motivo para a solicitação de elevação fornecido pelo usuário.
RoleId	Obrigatórios. O identificador exclusivo (GUID) da função do PAM a elevar.
RequestedTTL	Obrigatórios. O tempo de expiração solicitado em segundos.
RequestedTime	Opcional. O tempo para elevar os 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, RequestedTTL e RequestedTime como propriedades no corpo da solicitação, em vez de como parâmetros de consulta. O parâmetro v só pode ser especificado como um parâmetro de consulta.

Cabeçalhos da solicitação

Para 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, RequestedTTL e RequestedTime podem ser especificados como propriedades de um corpo da 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	OK
401	Não Autorizado
403	Proibido
408	Tempo Limite da Solicitação
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 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 identificador exclusivo (GUID) para a solicitação de PAM.
CreatorID	O identificador exclusivo (GUID) no serviço do MIM para a conta que criou a solicitação.
Justificativa	O motivo para a 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 identificador exclusivo (GUID) da função de 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 "Processando", "Ativo", "Fechado", "Fechando", "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"
}

Compartilhar via