Freigeben über

ABRUFEN von PAM-Anforderungen

Wird von einem privilegierten Konto verwendet, um einen Verlauf der zuvor veröffentlichten PAM-Anforderungen zurückzugeben.

Hinweis

Die URLs in diesem Artikel beziehen sich auf den Hostnamen, der während der API-Bereitstellung ausgewählt wird, z. B. https://api.contoso.com.

Anfrage

Methode Anforderungs-URL
ERHALTEN/Bekommen /api/pamresources/pamrequests

Abfrageparameter

Parameter BESCHREIBUNG
$filter Wahlfrei. Geben Sie eine der PAM-Anforderungseigenschaften in einem Filterausdruck an, um eine gefilterte Liste der Antworten zurückzugeben. Weitere Informationen zu unterstützten Operatoren finden Sie unter Filterung in PAM REST API-Dienstdetails.
v Wahlfrei. Die API-Version. Wenn sie nicht enthalten ist, wird die aktuelle (zuletzt veröffentlichte) Version der API verwendet. Weitere Informationen finden Sie unter Versionsverwaltung in PAM REST API-Dienstdetails.

Anforderungsheader

Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in PAM REST API-Dienstdetails.

Anfragekörper

Keiner.

Antwort

In diesem Abschnitt wird die Antwort beschrieben.

Antwortcodes

Code BESCHREIBUNG
200 OKAY
401 Nicht autorisiert
403 Verboten
408 Anforderungstimeout
500 Interner Serverfehler
503 Dienst nicht verfügbar

Antwortheader

Allgemeine Anforderungsheader finden Sie unter HTTP-Anforderungs- und Antwortheader in PAM REST API-Dienstdetails.

Antwortkörper

Eine erfolgreiche Antwort enthält eine Liste von PAM-Anforderungsobjekten mit den folgenden Eigenschaften:

Eigentum BESCHREIBUNG
RequestID Der eindeutige Bezeichner (GUID) für die PAM-Anforderung.
CreatorID Ein eindeutiger Bezeichner (GUID) für das Active Directory-Konto, das die PAM-Anforderung erstellt hat.
Rechtfertigung Der Grund für die Erhöhung.
Anzeigename Der Anzeigename der PAM-Anforderung in MIM.
Erstellungszeit Die Erstellungszeit der Anforderung.
CreationMethod Die Methode, die zum Erstellen der Anforderung verwendet wird.
Ablaufzeit Die Ablaufzeit der Anforderung.
RoleID Der eindeutige Bezeichner (GUID) der PAM-Rolle.
RequestedTTL Das angeforderte Ablauftimeout in Sekunden.
RequestedTime Die angeforderte Zeit für die Erhöhung.
RequestedStatus Der Status der Anfrage. Die möglichen Werte sind "Active", "Closed", "Closing", "Expired", "PendingApproval" und "Rejected".

Beispiel

Dieser Abschnitt enthält ein Beispiel zum Abrufen der bereitgestellten PAM-Anforderungen.

Beispiel: Anforderung

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

Beispiel: Antwort

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"
        }
    ]
}
  • Last updated on