Criar pedido DE PAM

Usado por uma conta privilegiada para elevar para um papel DE PAM.

Nota

Os URLs deste artigo são relativos ao nome de anfitrião escolhido durante a implantação da API, tais como https://api.contoso.com .

Pedir

Método URL do Pedido
POST /api/pamresources/pamrequests

Parâmetros de consulta

Parâmetro Descrição
Justificação Opcional. O motivo fornecido pelo utilizador para o pedido de elevação.
RoleId Obrigatório. O identificador único (GUID) do papel PAM para elevar.
SolicitadoTTL Obrigatório. O tempo de validade solicitado, em segundos.
Hora Solicitada Opcional. É hora de elevar os privilégios.
v Opcional. A versão API. Se não estiver incluída, utiliza-se a versão atual (mais recentemente lançada) da API. Para obter mais informações, consulte a versão em detalhes do serviço API PAM REST.

Nota

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

Cabeçalhos do pedido

Para cabeçalhos de pedido comuns, consulte os cabeçalhos de pedido e resposta HTTP nos dados do serviço API PAM REST.

Corpo do pedido

Opcional. Os parâmetros justificação, RoleId, RequestedTTL e RequestedTime podem ser especificados como propriedades de um órgão de pedido em vez de os especificar na cadeia de consulta 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 interno do servidor
503 Serviço Indisponível

Cabeçalhos de resposta

Para cabeçalhos de pedido comuns, consulte os cabeçalhos de pedido e resposta HTTP nos dados do serviço API PAM REST.

Corpo da resposta

Uma resposta bem sucedida contém um objeto de pedido PAM com as seguintes propriedades:

Propriedade Descrição
RequestID O identificador único (GUID) para o pedido de PAM.
CreatorID O identificador único (GUID) no serviço MIM para a conta que criou o pedido.
Justificação O motivo da elevação.
HoraDaCriação O tempo de criação do pedido.
CriaçãoMethod O método usado para criar o pedido.
ExpirationTime O prazo de validade do pedido.
RoleID O identificador único (GUID) do papel PAM.
SolicitadoTTL O prazo de validade solicitado em segundos.
Hora Solicitada O tempo solicitado para a elevação.
PedidoStatus O estado do pedido. Os valores possíveis são "Processamento", "Ativo", "Fechado", "Fechado", "Expirado", "Pendente de Aprovação", "PendenteMFA" 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"
}