Compartir a través de

Creación de una solicitud de PAM

  • Artículo

Utilizada por una cuenta con privilegios, la eleva a un rol de PAM.

Nota

Las direcciones URL de este artículo son relativas al nombre de host elegido durante la implementación de la API, como https://api.contoso.com.

Solicitud

Método URL de solicitud
POST /api/pamresources/pamrequests

Parámetros de consulta

Parámetro Descripción
Justificación Opcional. Motivo para la solicitud de elevación proporcionado por el usuario.
RoleId Necesario. Identificador único (GUID) del rol de PAM al que se elevarán los privilegios.
RequestedTTL Necesario. Tiempo de expiración solicitado, en segundos.
RequestedTime Opcional. Tiempo para elevar los privilegios.
v Opcional. Versión de la API. Si no se incluye, se usa la versión actual (publicada más recientemente) de la API. Para obtener más información, consulte Control de versiones en los detalles del servicio de API REST de PAM.

Nota

Puede especificar los parámetros Justification, RoleId, RequestedTTL y RequestedTime como propiedades en el cuerpo de la solicitud, en lugar de como parámetros de consulta. El parámetro v solo se puede especificar como parámetro de consulta.

Encabezados de solicitud

Para ver los encabezados de solicitud comunes, consulte Encabezados de solicitud HTTP y respuesta en los detalles del servicio de LA API REST de PAM.

Cuerpo de la solicitud

Opcional. Los parámetros Justification, RoleId, RequestedTTL y RequestedTime se pueden especificar como propiedades de un cuerpo de la solicitud en lugar de especificarlos en la cadena de consulta url.

Response

En esta sección se describe la respuesta.

Códigos de respuesta

Código Descripción
200 Aceptar
401 No autorizado
403 Prohibido
408 Tiempo de espera de solicitud
500 Internal Server Error
503 Servicio no disponible

Encabezados de respuesta

Para ver los encabezados de solicitud comunes, consulte Encabezados de solicitud HTTP y respuesta en los detalles del servicio de LA API REST de PAM.

Response body

Una respuesta correcta contiene un objeto de solicitud pam con las siguientes propiedades:

Propiedad Descripción
RequestID Identificador único (GUID) para la solicitud de PAM.
CreatorID Identificador único (GUID) en el servicio MIM para la cuenta que creó la solicitud.
Justificación Motivo de la elevación.
CreationTime Hora de creación de la solicitud.
CreationMethod Método usado para crear la solicitud.
ExpirationTime Hora de expiración de la solicitud.
RoleID Identificador único (GUID) del rol de PAM.
RequestedTTL Tiempo de espera de expiración solicitado en segundos.
RequestedTime Tiempo solicitado para la elevación.
RequestStatus Estado de la solicitud. Los valores posibles son "Processing", "Active", "Closed", "Closing", "Expired", "PendingApproval", "PendingMFA" y "Rejected".

Ejemplo

En esta sección se proporcionan ejemplos para crear una solicitud pam.

Ejemplo: Solicitud 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

Ejemplo: Respuesta 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"
}

Ejemplo: Solicitud 2

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

Ejemplo: Respuesta 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"
}