Freigeben über

PAM-Anforderung erstellen

Wird von einem privilegierten Konto verwendet, um eine PAM-Rolle zu erhöhen.

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
SENDEN /api/pamresources/pamrequests

Abfrageparameter

Parameter BESCHREIBUNG
Rechtfertigung Wahlfrei. Der vom Benutzer angegebene Grund für die Rechteerweiterungsanforderung.
RoleId Erforderlich. Der eindeutige Bezeichner (GUID) der PAM-Rolle, auf die er erhöht werden soll.
RequestedTTL Erforderlich. Die angeforderte Ablaufzeit in Sekunden.
RequestedTime Wahlfrei. Die Zeit zum Erhöhen von Berechtigungen.
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.

Hinweis

Sie können die Parameter Begründung, RoleId, RequestedTTLund RequestedTime Parameter als Eigenschaften im Anforderungstext und nicht als Abfrageparameter angeben. Der parameter v kann nur als Abfrageparameter angegeben werden.

Anforderungsheader

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

Anfragekörper

Wahlfrei. Die Begründung, RoleId, RequestedTTL-und RequestedTime Parameter können als Eigenschaften eines Anforderungstexts angegeben werden, anstatt sie in der URL-Abfragezeichenfolge anzugeben.

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 ein PAM-Anforderungsobjekt mit den folgenden Eigenschaften:

Eigentum BESCHREIBUNG
RequestID Der eindeutige Bezeichner (GUID) für die PAM-Anforderung.
CreatorID Der eindeutige Bezeichner (GUID) im MIM-Dienst für das Konto, das die Anforderung erstellt hat.
Rechtfertigung Der Grund für die Erhöhung.
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.
RequestStatus Der Status der Anfrage. Die möglichen Werte sind "Processing", "Active," "Closed," "Closing", "Expired," "PendingApproval," "PendingMFA" und "Rejected".

Beispiel

Dieser Abschnitt enthält Beispiele zum Erstellen einer PAM-Anforderung.

Beispiel: Anforderung 1

POST /api/pamresources/pamrequests?Justification=Sample+Reason&RoleId=00000000-0000-0000-0000-000000000000&RequestedTTL=7200&RequestedTime=2015%2F07%2F11+23%3A40 HTTP/1.1

Beispiel: Antwort 1

HTTP/1.1 201 Created

{  
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests/@Element",
    "RequestId":"c0112f13-b16b-40ad-b547-07f23a7fba52",
    "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
    "Justification":"Sample Reason",
    "CreationTime":"2015-07-11T23:38:09.036164-07:00",
    "CreationMethod":"PAM Web API",
    "ExpirationTime":"0001-01-01T00:00:00",
    "RoleId":"00000000-0000-0000-0000-000000000000",
    "RequestedTTL":"7200",
    "RequestedTime":"2015-07-12T06:40:00Z",
    "RequestStatus":"PendingApproval"
}

Beispiel: Anforderung 2

POST /api/pamresources/pamrequests?Justification=&RoleId=00000000-0000-0000-0000-000000000000&RequestedTTL=3600&RequestedTime= HTTP/1.1

Beispiel: Antwort 2

HTTP/1.1 201 Created

{
    "odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#pamrequests/@Element",
    "RequestId":"504f9c49-00db-42bd-a157-ee5664617189",
    "CreatorID":"73257e5e-00b3-4309-a330-f1e607ff113a",
    "Justification":null,
    "CreationTime":"2015-07-11T23:07:30.2200123-07:00",
    "CreationMethod":"PAM Web API",
    "ExpirationTime":"0001-01-01T00:00:00",
    "RoleId":"00000000-0000-0000-0000-000000000000",
    "RequestedTTL":"3600",
    "RequestedTime":"2015-07-12T06:07:27.7229894Z",
    "RequestStatus":"PendingApproval"
}
  • Last updated on