Obtención de solicitudes pam pendientes

Artículo
09/14/2023

Lo usa una cuenta con privilegios para devolver una lista de solicitudes pendientes que necesitan aprobación.

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
GET	/api/pamresources/pamrequeststoapprove

Parámetros de consulta

Parámetro	Descripción
$filter	Opcional. Especifique cualquiera de las propiedades de solicitud de PAM pendientes en una expresión de filtro para devolver una lista filtrada de respuestas. Para obtener más información sobre los operadores admitidos, consulte Filtrado en los detalles del servicio de LA API REST de PAM.
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.

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

Ninguno.

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 una lista de objetos de aprobación de solicitudes de PAM con las siguientes propiedades:

Propiedad	Descripción
RoleName	Nombre para mostrar del rol para el que se necesita aprobación.
Solicitante	Nombre de usuario del solicitante que se debe aprobar.
Justificación	Justificación proporcionada por el usuario.
RequestedTTL	Tiempo de expiración solicitado en segundos.
RequestedTime	Tiempo solicitado para la elevación.
CreationTime	Hora de creación de la solicitud.
FIMRequestID	Contiene un único elemento, "Value", con el identificador único (GUID) de la solicitud de PAM.
RequestorID	Contiene un único elemento, "Value", con el identificador único (GUID) de la cuenta de Active Directory que creó la solicitud de PAM.
ApprovalObjectID	Contiene un único elemento, "Value", con el identificador único (GUID) para el objeto approval.

Ejemplo

En esta sección se proporciona un ejemplo para obtener las solicitudes pam pendientes.

Ejemplo: Solicitud

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

Ejemplo: Respuesta

HTTP/1.1 200 OK

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequeststoapprove",
    "value":[
        {
            "RoleName":"ApprovalRole",
            "Requestor":"PRIV.Jen",
            "Justification":"Justification Reason",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-07-11T22:25:00Z",
            "CreationTime":"2015-07-11T22:24:52.51Z",
            "FIMRequestID":{
                "Value":"9802d7b7-b4e9-4fe4-8f5c-649cda127e49"
            },
            "RequestorID":{
                "Value":"73257e5e-00b3-4309-a330-f1e607ff113a"
            },
            "ApprovalObjectID":{
                "Value":"5dbd9d0c-0a9d-4f75-8cbd-ff6ffdc00143"
            }
        }
    ]
}

Compartir a través de