Získání požadavků PAM

Článek
09/14/2023

Používá se privilegovaným účtem k vrácení historie dříve odeslaných požadavků PAM.

Poznámka

Adresy URL v tomto článku jsou relativní k názvu hostitele zvolenému během nasazování rozhraní API, například https://api.contoso.com.

Žádost

Metoda	Adresa URL požadavku
GET	/api/pamresources/pamrequests

Parametry dotazů

Parametr	Popis
$filter	Nepovinný parametr. Zadáním libovolných vlastností požadavku PAM ve výrazu filtru vrátíte filtrovaný seznam odpovědí. Další informace o podporovaných operátorech najdete v tématu Filtrování v podrobnostech služby PAM REST API.
v	Nepovinný parametr. Verze rozhraní API. Pokud není součástí, použije se aktuální (naposledy vydaná) verze rozhraní API. Další informace najdete v podrobnostech o správě verzí ve službě PAM REST API.

Hlavičky požadavku

Běžné hlavičky požadavků najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě PAM REST API.

Text požadavku

Žádné

Odpověď

Tato část popisuje odpověď.

Kódy odpovědí

Kód	Description
200	OK
401	Neautorizováno
403	Forbidden
408	Časový limit žádosti
500	Vnitřní chyba serveru
503	Nedostupná služba

Hlavičky odpovědi

Běžné hlavičky požadavků najdete v tématu Hlavičky požadavků HTTP a odpovědí v podrobnostech o službě PAM REST API.

Text odpovědi

Úspěšná odpověď obsahuje seznam objektů požadavků PAM s následujícími vlastnostmi:

Vlastnost	Popis
ID požadavku	Jedinečný identifikátor (GUID) požadavku PAM.
CreatorID (ID autora)	Jedinečný identifikátor (GUID) účtu služby Active Directory, který vytvořil požadavek PAM.
Zdůvodnění	Důvod zvýšení oprávnění.
DisplayName	Zobrazovaný název požadavku PAM v MIM.
CreationTime	Čas vytvoření požadavku.
Metoda vytváření	Metoda použitá k vytvoření požadavku.
ExpirationTime	Čas vypršení platnosti žádosti.
ID role	Jedinečný identifikátor (GUID) role PAM.
RequestedTTL	Požadovaný časový limit vypršení platnosti v sekundách.
Požadovaný čas	Požadovaný čas pro zvýšení oprávnění.
RequestedStatus	Stav žádosti. Možné hodnoty jsou "Active", "Closed", "Closing", "Expired", "PendingApproval" a "Rejected".

Příklad

Tato část obsahuje příklad získání publikovaných požadavků PAM.

Příklad: Žádost

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

Příklad: Odpověď

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

Sdílet prostřednictvím