Ottenere le richieste PAM

Articolo
03/22/2025

Usato da un account con privilegi per restituire una cronologia delle richieste PAM pubblicate in precedenza.

Nota

Gli URL in questo articolo sono relativi al nome host scelto durante la distribuzione dell'API, ad esempio https://api.contoso.com.

Richiesta

Metodo	URL richiesta
GET	/api/pamresources/pamrequests

Parametri di query

Parametro	Descrizione
$filtro	Opzionale. Specificare una delle proprietà della richiesta PAM in un'espressione di filtro per restituire un elenco filtrato di risposte. Per altre informazioni sugli operatori supportati, vedere Filtro nei dettagli del servizio API REST PAM.
v	Opzionale. Versione dell'API. Se non è inclusa, viene usata la versione corrente (rilasciata più di recente) dell'API. Per altre informazioni, vedere Controllo delle versioni nel servizio API REST PAM.

Header di richiesta

Per le intestazioni di richiesta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli servizio API REST PAM.

Testo della richiesta

Nessuno.

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice	Descrizione
200	Va bene
401	Non autorizzata
403	Vietato
408	Timeout richiesta
500	Errore Interno del Server
503	Servizio non disponibile

Intestazioni di risposta

Per le intestazioni di richiesta comuni, vedere intestazioni di richiesta e risposta HTTP nei dettagli servizio API REST PAM.

Corpo della risposta

Una risposta con esito positivo contiene un elenco di oggetti richiesta PAM con le proprietà seguenti:

Proprietà	Descrizione
RequestID	Identificatore univoco (GUID) per la richiesta PAM.
CreatorID	Identificatore univoco (GUID) per l'account Active Directory che ha creato la richiesta PAM.
Giustificazione	Motivo dell'elevazione.
Nome visualizzato	Nome visualizzato della richiesta PAM in MIM.
Orario di creazione	Ora di creazione della richiesta.
CreationMethod	Metodo utilizzato per creare la richiesta.
ExpirationTime	Ora di scadenza della richiesta.
RoleID	Identificatore univoco (GUID) del ruolo PAM.
RequestedTTL	Timeout di scadenza richiesto in secondi.
RequestedTime	Tempo richiesto per l'elevazione.
RequestedStatus	Stato della richiesta. I valori possibili sono "Active", "Closed", "Closing", "Expired", "PendingApproval" e "Rejected".

Esempio

Questa sezione fornisce un esempio per ottenere le richieste PAM inviate.

Esempio: richiesta

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

Esempio: risposta

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"
        }
    ]
}

Condividi tramite