Pobieranie oczekujących żądań PAM

  • Artykuł

Używane przez uprzywilejowane konto do zwracania listy oczekujących żądań, które wymagają zatwierdzenia.

Uwaga

Adresy URL w tym artykule są powiązane z nazwą hosta wybraną podczas wdrażania interfejsu API, taką jak https://api.contoso.com.

Żądanie

Metoda Adres URL żądania
GET /api/pamresources/pamrequeststoapprove

Parametry zapytania

Parametr Opis
$filter Opcjonalny. Określ dowolne z oczekujących właściwości żądania PAM w wyrażeniu filtru, aby zwrócić filtrowaną listę odpowiedzi. Aby uzyskać więcej informacji na temat obsługiwanych operatorów, zobacz Filtrowanie w usłudze API REST usługi PAM.
v Opcjonalny. Wersja interfejsu API. Jeśli nie zostanie uwzględniona, zostanie użyta bieżąca (ostatnio wydana) wersja interfejsu API. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji w usłudze API REST usługi PAM.

Nagłówki żądań

Aby zapoznać się z typowymi nagłówkami żądań, zobacz Http request and response headers (Nagłówki żądań HTTP i odpowiedzi ) w temacie PAM REST API details (Szczegóły usługi API REST usługi PAM).

Treść żądania

Brak.

Reakcja

W tej sekcji opisano odpowiedź.

Kody odpowiedzi

Kod Opis
200 OK
401 Brak autoryzacji
403 Forbidden
408 Limit czasu żądania
500 Wewnętrzny błąd serwera
503 Usługa niedostępna

Nagłówki odpowiedzi

Aby zapoznać się z typowymi nagłówkami żądań, zobacz Http request and response headers (Nagłówki żądań HTTP i odpowiedzi ) w temacie PAM REST API details (Szczegóły usługi API REST usługi PAM).

Treść odpowiedzi

Pomyślna odpowiedź zawiera listę obiektów zatwierdzania żądań PAM z następującymi właściwościami:

Właściwość Opis
RoleName Nazwa wyświetlana roli, dla której jest wymagane zatwierdzenie.
Requestor Nazwa użytkownika osoby żądającej, która ma zostać zatwierdzona.
Uzasadnienie Uzasadnienie podane przez użytkownika.
Żądany czas wygaśnięcia Żądany czas wygaśnięcia w sekundach.
RequestedTime Żądany czas podniesienia uprawnień.
CreationTime Czas utworzenia żądania.
IDENTYFIKATOR FIMRequestID Zawiera pojedynczy element "Value" z unikatowym identyfikatorem (GUID) żądania PAM.
Identyfikator żądania Zawiera pojedynczy element "Value" z unikatowym identyfikatorem (GUID) dla konta usługi Active Directory, które utworzyło żądanie PAM.
Identyfikator obiektu ApprovalObjectID Zawiera pojedynczy element "Value" z unikatowym identyfikatorem (GUID) obiektu zatwierdzenia.

Przykład

Ta sekcja zawiera przykład pobierania oczekujących żądań PAM.

Przykład: żądanie

GET /api/pamresources/pamrequeststoapprove HTTP/1.1

Przykład: odpowiedź

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