Creación de una solicitud pam

Usado por una cuenta con privilegios para elevar 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
PUBLICAR	/api/pamresources/pamrequests

Parámetros de consulta

Parámetro	Descripción
Justificación	Opcional. Motivo proporcionado por el usuario para la solicitud de elevación.
RoleId	Obligatorio. Identificador único (GUID) del rol PAM al que se va a elevar.
RequestedTTL	Obligatorio. Tiempo de expiración solicitado, en segundos.
RequestedTime	Opcional. El tiempo para elevar privilegios.
v	Opcional. La 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 api rest de PAM.

Nota:

Puede especificar los parámetros Justificación, RoleId, RequestedTTLy 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 obtener encabezados de solicitud comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de PAM.

Cuerpo de la solicitud

Opcional. Los de justificación de, RoleId, RequestedTTLy requestedTime parámetros se pueden especificar como propiedades de un cuerpo de solicitud en lugar de especificarlos en la cadena de consulta url.

Respuesta

En esta sección se describe la respuesta.

Códigos de respuesta

Código	Descripción
200	De acuerdo
401	Desautorizado
403	Prohibido
408	Tiempo de espera de solicitud
500	Error interno del servidor
503	Servicio no disponible

Encabezados de respuesta

Para obtener encabezados de solicitud comunes, consulte encabezados de solicitud y respuesta HTTP en detalles del servicio de API REST de PAM.

Cuerpo de la respuesta

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

Propiedad	Descripción
RequestID	Identificador único (GUID) de la solicitud pam.
CreatorID	Identificador único (GUID) en el servicio MIM de la cuenta que creó la solicitud.
Justificación	Motivo de 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 PAM.
RequestedTTL	Tiempo de espera de expiración solicitado en segundos.
RequestedTime	Hora solicitada para la elevación.
RequestStatus	El 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"
}