Hämta PAM-begäranden

Artikel
03/22/2025

Används av ett privilegierat konto för att returnera en historik över tidigare publicerade PAM-begäranden.

Anmärkning

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.

Begäran

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

Frågeparametrar

Parameter	Beskrivning
$filter	Valfritt. Ange någon av 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.

Förfrågningsrubriker

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

begäranens innehåll

Ingen.

Svar

I det här avsnittet beskrivs svaret.

Svarskoder

Kod	Beskrivning
200	OK
401	Otillåten
403	Ej tillåtet
408	Tidsgräns för förfrågan
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.

Svarsdel

Ett lyckat svar innehåller en lista över PAM-begärandeobjekt med följande egenskaper:

Fastighet	Beskrivning
RequestID	Den unika identifieraren (GUID) för PAM-begäran.
CreatorID	En unik identifierare (GUID) för Det Active Directory-konto som skapade PAM-begäran.
Rättfärdigande	Anledningen till höjningen.
visningsnamn	PAM-begärans visningsnamn i MIM.
CreationTime	Tiden då begäran skapades.
CreationMethod	Den metod som används för att skapa begäran.
ExpirationTime	Förfallotiden för begäran.
RoleID	Den unika identifieraren (GUID) för PAM-rollen.
RequestedTTL	Den begärda tidsgränsen för förfallodatum i sekunder.
RequestedTime	Begärd tid för höjning.
RequestedStatus	Status för begäran. Möjliga värden är "Active", "Closed", "Closing", "Expired", "PendingApproval" och "Rejected".

Exempel

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

Exempel: begäran

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

Exempel: svar

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

Dela via