Aktualisieren von approvalStage

Namespace: microsoft.graph

Genehmigen oder verweigern Sie ein approvalStage-Objekt in einer Genehmigung.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Erforderliche Berechtigungen zum Aufrufen dieser API für die Berechtigungsverwaltung

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) EntitlementManagement.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung Nicht unterstützt

Erforderliche Berechtigungen zum Aufrufen dieser API für PIM für Gruppen

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung Nicht unterstützt

HTTP-Anforderung

So aktualisieren Sie eine Genehmigungsentscheidung in der Berechtigungsverwaltung:

PATCH /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{accessPackageAssignmentRequestId}/stages/{approvalStageId}

So aktualisieren Sie eine Genehmigungsentscheidung in PIM für Gruppen:

PATCH /identityGovernance/privilegedAccess/group/assignmentApprovals/{privilegedaccessgroupassignmentschedulerequestId}/steps/{approvalStageId}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die für diese Methode erforderlich sind.

Eigenschaft Typ Beschreibung
reviewResult String Entscheidung der genehmigenden Person. Mögliche Werte sind: Approve und Deny. Erforderlich.
Rechtfertigung String Begründung im Zusammenhang mit der Entscheidung der genehmigenden Person.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 204 No Content Antwortcode im Antworttext zurück. Wenn der Aufrufer nicht über die richtigen Berechtigungen verfügt, gibt die Methode einen 403 Forbidden Antwortcode zurück, oder wenn die Genehmigungs-ID nicht gefunden wird, gibt die Methode zurück 404 Not found. Wenn die Anforderung bereits von einer anderen genehmigenden Person in derselben Genehmigungsphase genehmigt wurde, gibt die Methode den Antwortcode zurück 409 Conflict .

Beispiele

Anforderung

PATCH https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/abd306ef-f7b2-4a10-9fd1-493454322489/stages/d4fa4045-4716-436d-aec5-57b0a713f095

{
 "reviewResult":"Approve",
 "justification":"OK"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content