approverDelegate aktualisieren

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Erstellen oder ersetzen Sie das ApproverDelegate-Objekt , das für einen Benutzer konfiguriert ist. Der genehmigende Stellvertreter kann Anforderungen zur Berechtigungsverwaltung, Zugriffspakete und Zugriffsüberprüfungen von Microsoft Entra im Namen des Benutzers für den im Zeitplan angegebenen Zeitraum genehmigen oder verweigern.

Die Delegierung gilt für alle Zugriffspaketzuweisungsanforderungen und Zugriffsüberprüfungen, die dem Benutzer zugewiesen werden. Während die Delegierung in Kraft ist, kann der Benutzer seine eigenen ausstehenden Elemente weiterhin genehmigen oder ablehnen.

Angemeldete Benutzer können ihre eigene genehmigende Stellvertretung festlegen. Administratoren können die genehmigende Stellvertretung für jeden Benutzer im Mandanten festlegen.

Da es sich bei dieser Methode um einen PUT Vorgang handelt, ersetzt der Anforderungstext den vorhandenen Genehmigenden Delegaten. Um eine Delegierung zu beenden, übermitteln Sie eine neue genehmigende Stellvertretung mit einem Zeitplan, der bereits abgelaufen ist.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	EntitlementManagement.ReadWrite.All	Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Application	Nicht unterstützt	Nicht unterstützt

Wichtig

Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. Der Identity Governance-Administrator ist die Rolle mit den geringsten Berechtigungen, die für diesen Vorgang unterstützt wird.

Es ist keine Verzeichnisrolle erforderlich, um eine eigene genehmigende Stellvertretung über den /me Pfad festzulegen.

HTTP-Anforderung

So legen Sie die genehmigende Stellvertretung für den angemeldeten Benutzer fest:

PUT /me/identityGovernance/approverDelegate

So legen Sie die genehmigende Stellvertretung eines anderen Benutzers fest:

PUT /users/{user-id}/identityGovernance/approverDelegate

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type	application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des ApproverDelegate-Objekts an.

Die folgende Tabelle zeigt die Eigenschaften, die Sie verwenden können, wenn Sie eine genehmigende Stellvertretung festlegen.

Eigenschaft	Typ	Beschreibung
Delegieren	userSet	Der Benutzer oder die Gruppe, der/die die Genehmigungsdelegierung erhält. Geben Sie die @odata.type Eigenschaft an, um den Untertyp zu identifizieren. Nur die Untertypen "singleUser" und "groupMembers" werden unterstützt. Erforderlich.
Zeitplan	requestSchedule	Der Zeitraum, in dem die Delegierung wirksam ist. Wenn Sie keinen Zeitplan angeben, beginnt die Delegierung sofort und läuft nicht ab. Optional.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Sie gibt nichts im Antworttext zurück.

Fehler

Diese Methode gibt den folgenden Fehler zurück, wenn der Delegate kein unterstützter userSet-Untertyp ist oder wenn der Delegat nicht aufgelöst werden kann.

HTTP-Statuscode	Fehlercode	Fehlermeldung
400	Request_BadRequest	Ungültige oder nicht unterstützte genehmigende Stellvertretung.

Beispiele

Beispiel 1: Festlegen eines Benutzers als genehmigenden Stellvertreter des angemeldeten Benutzers

Anforderung

Im folgenden Beispiel werden Genehmigungen für eine Woche an einen einzelnen Benutzer delegiert.

PUT https://graph.microsoft.com/beta/me/identityGovernance/approverDelegate
Content-type: application/json

{
  "delegate": {
    "@odata.type": "#microsoft.graph.singleUser",
    "id": "d8f4bcd2-4d5a-4a1e-88a5-b0f1c98d2f27"
  },
  "schedule": {
    "startDateTime": "2026-08-31T08:21:41.338Z",
    "expiration": {
      "endDateTime": "2026-09-07T08:21:41.339Z",
      "type": "afterDateTime"
    }
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 2: Festlegen einer Gruppe als genehmigender Stellvertreter eines anderen Benutzers

Anforderung

Im folgenden Beispiel werden Genehmigungen für einen anderen Benutzer ohne Ablaufdatum an die Mitglieder einer Gruppe delegiert.

PUT https://graph.microsoft.com/beta/users/87ec4b08-df41-4e9c-8f0c-2e6c9e19b0d3/identityGovernance/approverDelegate
Content-type: application/json

{
  "delegate": {
    "@odata.type": "#microsoft.graph.groupMembers",
    "id": "1c5f0b3e-8d4a-4e39-9f2b-6a7c1d3e5f80"
  },
  "schedule": {
    "startDateTime": "2026-08-31T08:21:41.338Z",
    "expiration": {
      "type": "noExpiration"
    }
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content