Compartir a través de

Obtención de solicitudes pam pendientes

Usado por 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
OBTÉN /api/pamresources/pamrequeststoapprove

Parámetros de consulta

Parámetro Descripción
$filter Opcional. Especifique cualquiera de las propiedades de solicitud 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 API REST de PAM.
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.

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

Ninguno.

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 una lista de objetos de aprobación de solicitudes 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 va a aprobar.
Justificación Justificación proporcionada por el usuario.
RequestedTTL Tiempo de expiración solicitado en segundos.
RequestedTime Hora solicitada 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 PAM.
RequestorID Contiene un único elemento, "Valor", con el identificador único (GUID) de la cuenta de Active Directory que creó la solicitud 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"
            }
        }
    ]
}
  • Last updated on