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