Hämta väntande PAM-begäranden

Artikel
09/14/2023

Används av ett privilegierat konto för att returnera en lista över väntande begäranden som behöver godkännande.

Anteckning

URL:erna i den här artikeln är relativa till det värdnamn som väljs under API-distributionen, till exempel https://api.contoso.com.

Förfrågan

Metod	Begärans-URL
GET	/api/pamresources/pamrequeststoapprove

Frågeparametrar

Parameter	Beskrivning
$filter	Valfritt. Ange någon av de väntande EGENSKAPERNA för PAM-begäran i ett filteruttryck för att returnera en filtrerad lista med svar. Mer information om operatorer som stöds finns i Filtrering i PAM REST API-tjänstinformation.
v	Valfritt. API-versionen. Om den inte ingår används den aktuella (senast utgivna) versionen av API:et. Mer information finns i Versionshantering i PAM REST API-tjänstinformation.

Begärandehuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i PAM REST API-tjänstinformation.

Begärandetext

Inga.

Svarsåtgärder

I det här avsnittet beskrivs svaret.

Svarskoder

Kod	Description
200	OK
401	Behörighet saknas
403	Förbjudet
408	Timeout för begäran
500	Internt serverfel
503	Tjänsten är inte tillgänglig

Svarshuvuden

Vanliga begärandehuvuden finns i HTTP-begärande- och svarshuvuden i PAM REST API-tjänstinformation.

Själva svaret

Ett lyckat svar innehåller en lista över objekt för GODKÄNNANDE av PAM-begäranden med följande egenskaper:

Egenskap	Beskrivning
RoleName	Visningsnamnet för rollen som godkännande krävs för.
Requestor	Användarnamnet för den begärande som ska godkännas.
Motivering	Den motivering som användaren har angett.
RequestedTTL	Begärd förfallotid i sekunder.
RequestedTime	Begärd tid för höjning.
SkapadTid	Tiden då begäran skapades.
FIMRequestID	Innehåller ett enda element, "Value", med den unika identifieraren (GUID) för PAM-begäran.
RequestorID	Innehåller ett enda element, "Value", med den unika identifieraren (GUID) för Det Active Directory-konto som skapade PAM-begäran.
ApprovalObjectID	Innehåller ett enda element, "Value", med den unika identifieraren (GUID) för godkännandeobjektet.

Exempel

Det här avsnittet innehåller ett exempel för att hämta väntande PAM-begäranden.

Exempel: Begäran

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

Exempel: Svar

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

Dela via