Ottenere richieste PAM in sospeso

Articolo
09/14/2023

Utilizzato da un account con privilegi per restituire un elenco di richieste in sospeso che richiedono l’approvazione.

Nota

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

Richiesta

Metodo	URL richiesta
GET	/api/pamresources/pamrequeststoapprove

Parametri di query

Parametro	Descrizione
$filter	Facoltativa. Specificare una delle proprietà della richiesta PAM in sospeso 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	Facoltativa. La versione delle API. Se non è incluso, viene usata la versione corrente (più recente rilasciata) dell'API. Per altre informazioni, vedere Controllo delle versioni nel servizio API REST PAM.

Intestazioni della richiesta

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

Testo della richiesta

Nessuno.

Risposta

Questa sezione descrive la risposta.

Codici di risposta

Codice	Descrizione
200	OK
401	Non autorizzata
403	Accesso negato
408	Timeout richiesta
500	Internal Server Error
503	Servizio non disponibile

Intestazioni di risposta

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

Corpo della risposta

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

Proprietà	Descrizione
RoleName	Il nome visualizzato del ruolo per cui è necessaria l'approvazione.
Richiedente	Il nome utente del richiedente da approvare.
Giustificazione	La giustificazione fornita dall'utente.
RequestedTTL	Ora di scadenza richiesta, in secondi.
RequestedTime	Il tempo richiesto per l'elevazione dei privilegi.
CreationTime	Ora di creazione della richiesta.
FIMRequestID	Contiene un singolo elemento, "Value", con l'identificatore univoco (GUID) della richiesta PAM.
RequestorID	Contiene un singolo elemento, "Value", con l'identificatore univoco (GUID) per l'account Active Directory che ha creato la richiesta PAM.
ApprovalObjectID	Contiene un singolo elemento, "Value", con l'identificatore univoco (GUID) per l'oggetto Approvazione.

Esempio

Questa sezione fornisce un esempio per ottenere le richieste PAM in sospeso.

Esempio: Richiesta

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

Esempio: Risposta

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

Condividi tramite