Dela via


Hämta PAM-begäranden

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

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

Frågeparametrar

Parameter Beskrivning
$filter Valfritt. Ange någon av PAM-begärandeegenskaperna 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 PAM-begärandeobjekt med följande egenskaper:

Egenskap Beskrivning
RequestID Den unika identifieraren (GUID) för PAM-begäran.
CreatorID En unik identifierare (GUID) för Active Directory-kontot som skapade PAM-begäran.
Motivering Anledningen till höjningen.
DisplayName PAM-begärans visningsnamn i MIM.
SkapadTid 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örfallotid 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ärandena.

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