Creación de una solicitud de PAM

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=c28eab4a-95cf-4c08-a153-d5e8a9e660cd&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":"c28eab4a-95cf-4c08-a153-d5e8a9e660cd",
    "RequestedTTL":"7200",
    "RequestedTime":"2015-07-12T06:40:00Z",
    "RequestStatus":"PendingApproval"
}

Ejemplo: Solicitud 2

POST /api/pamresources/pamrequests?Justification=&RoleId=c28eab4a-95cf-4c08-a153-d5e8a9e660cd&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":"c28eab4a-95cf-4c08-a153-d5e8a9e660cd",
    "RequestedTTL":"3600",
    "RequestedTime":"2015-07-12T06:07:27.7229894Z",
    "RequestStatus":"PendingApproval"
}