Compartir a través de

Obtención de solicitudes de PAM

  • Artículo

Lo usa una cuenta con privilegios para devolver un historial de solicitudes de PAM enviadas previamente.

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/pamrequests

Parámetros de consulta

Parámetro Descripción
$filter Opcional. Especifique cualquiera de las propiedades de solicitud pam 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. 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 y respuesta HTTP en los detalles del servicio de 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 y respuesta HTTP en los detalles del servicio de API REST de PAM.

Response body

Una respuesta correcta contiene una lista de objetos de solicitud pam con las siguientes propiedades:

Propiedad Descripción
RequestID Identificador único (GUID) para la solicitud de PAM.
CreatorID Identificador único (GUID) para la cuenta de Active Directory que creó la solicitud de PAM.
Justificación Motivo de la elevación.
DisplayName Nombre para mostrar de la solicitud de PAM en MIM.
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.
RequestedStatus Estado de la solicitud. Los valores posibles son "Active", "Closed", "Closing", "Expired", "PendingApproval" y "Rejected".

Ejemplo

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

Ejemplo: Solicitud

GET /api/pamresources/pamrequests?$filter=CreationTime%20gt%20datetime'2015-06-12T04:49:32.431Z'%20and%20CreationTime%20lt%20datetime'2015-07-13T04:49:32.432Z' HTTP/1.1

Ejemplo: Respuesta

HTTP/1.1 200 OK

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests",
    "value":[
        {
            "RequestId":"b22e1343-9a2b-4e33-a70a-1bb7b2d405b9",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":null,
            "CreationTime":"2015-06-23T11:34:38.58Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-06-23T12:34:38.847Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-06-23T11:34:36.417Z",
            "RequestStatus":"Expired"
        },
        {
            "RequestId":"3a98d1c7-524d-4b72-9da7-bd9f907eab55",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"Reason for Request",
            "CreationTime":"2015-07-12T04:35:14.433Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-07-12T04:43:51.95Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"12960000",
            "RequestedTime":"2015-07-12T04:35:00Z",
            "RequestStatus":"Closed"
        },
        {
            "RequestId":"f5e80be1-e9a3-42c4-81f8-4be5a4a429f4",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":null,
            "CreationTime":"2015-07-12T04:48:17.46Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"2015-07-12T05:48:17.853Z",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-07-12T04:48:14.057Z",
            "RequestStatus":"Active"
        },
        {
            "RequestId":"b0f0ddc0-c809-4770-9d39-0d706f97a2de",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"",
            "CreationTime":"2015-06-30T07:01:13.147Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"0001-01-01T00:00:00",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"3600",
            "RequestedTime":"2015-06-30T07:01:13.119Z",
            "RequestStatus":"Rejected"
        },
        {
            "RequestId":"5ec10e61-cdd1-404e-a18e-740467d87dbf",
            "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
            "Justification":"Example Reason",
            "CreationTime":"2015-07-12T04:49:09.963Z",
            "CreationMethod":"PAM Web API",
            "ExpirationTime":"0001-01-01T00:00:00",
            "RoleId":"00000000-0000-0000-0000-000000000000",
            "RequestedTTL":"12960000",
            "RequestedTime":"2015-07-12T04:50:00Z",
            "RequestStatus":"PendingApproval"
        }
    ]
}