Získání čekajících žádostí PAM

Článek
03/22/2025

Používá se privilegovaným účtem k vrácení seznamu čekajících žádostí, které potřebují schválení.

Poznámka:

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

Žádost

Metoda	Adresa URL požadavku
ZÍSKAT	/api/pamresources/pamrequeststoapprove

Parametry dotazu

Parametr	Popis
$filter	Volitelný. Zadejte některou z vlastností čekajících žádostí PAM ve výrazu filtru, které vrátí 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	Volitelný. Verze rozhraní API. Pokud není zahrnutá, použije se aktuální (naposledy vydaná) verze rozhraní API. Další informace najdete v tématu Správa verzí ve službě PAM REST API podrobnosti.

Hlavičky žádosti

Běžné hlavičky požadavků najdete v tématu hlavičky požadavku HTTP a odpovědi v podrobnostech služby PAM REST API.

Obsah požadavku

Žádné.

Odpověď

Tato část popisuje odpověď.

Kódy odpovědí

Kód	Popis
200	OK
401	Neautorizováno
403	Zakázáno
408	Časový limit požadavku
500	Vnitřní chyba serveru
503	Služba není k dispozici

Hlavičky odpovědi

Běžné hlavičky požadavků najdete v tématu hlavičky požadavku HTTP a odpovědi v podrobnostech služby PAM REST API.

Obsah odpovědi

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

Vlastnictví	Popis
Název role	Zobrazovaný název role, pro kterou je potřeba schválení.
Žadatel	Uživatelské jméno žadatele, které má být schváleno.
Odůvodnění	Odůvodnění poskytnuté uživatelem.
RequestedTTL	Požadovaná doba vypršení platnosti v sekundách.
RequestedTime	Požadovaný čas pro zvýšení oprávnění.
CreationTime	Čas vytvoření požadavku.
FIMRequestID	Obsahuje jeden prvek Value s jedinečným identifikátorem (GUID) požadavku PAM.
ID žadatele	Obsahuje jeden prvek Value s jedinečným identifikátorem (GUID) pro účet služby Active Directory, který vytvořil požadavek PAM.
ApprovalObjectID	Obsahuje jeden prvek Value s jedinečným identifikátorem (GUID) objektu Schválení.

Příklad

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

Příklad: Požadavek

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

Příklad: Odpověď

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

Sdílet prostřednictvím