AccessReview-Prüfer hinzufügenAdd accessReview reviewer

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Aktualisieren Sie in der Funktion Azure AD Zugriffs Überprüfungen ein vorhandenes accessReview -Objekt, um einen anderen Benutzer als Prüfer hinzuzufügen.In the Azure AD access reviews feature, update an existing accessReview object to add another user as a reviewer. Dieser Vorgang ist nur für eine Access-Überprüfung zulässig, die noch nicht abgeschlossen ist, und nur für eine Zugriffsüberprüfung, bei der die Bearbeiter explizit angegeben werden.This operation is only permitted for an access review that is not yet completed, and only for an access review where the reviewers are explicitly specified. Dieser Vorgang ist für eine Zugriffsüberprüfung nicht zulässig, bei der Benutzer ihren eigenen Zugriff überprüfen und nicht für eine Zugriffsüberprüfung vorgesehen sind, in der die Gruppenbesitzer als Bearbeiter zugewiesen sind.This operation is not permitted for an access review in which users review their own access, and not intended for an access review in which the group owners are assigned as the reviewers.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) AccessReview. ReadWrite. Membership, AccessReview. ReadWrite. allAccessReview.ReadWrite.Membership, AccessReview.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication AccessReview. ReadWrite. MembershipAccessReview.ReadWrite.Membership

HTTP-AnforderungHTTP request

POST /accessReviews/{reviewId}/reviewers

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung der ID eines Benutzers an, der ein Prüfer sein wird.In the request body, supply a JSON representation of the ID of a user who will be a reviewer.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Aktualisieren einer accessReview bereitgestellt werden können.The following table shows the properties that can be supplied when you update an accessReview.

EigenschaftProperty TypType BeschreibungDescription
id String Die Benutzer-ID.The user ID.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 201, Created wird der Antwortcode zurückgegeben.If successful, this method returns a 201, Created response code .

BeispielExample

Dies ist ein Beispiel für die Aktualisierung einer einmaligen (nicht wiederkehrenden) Zugriffsüberprüfung mit einem zusätzlichen Prüfer.This is an example of updating a one-time (not reoccurring) access review with an additional reviewer.

AnforderungRequest

Geben Sie im Anforderungstext eine JSON-Darstellung der ID des User-Objekts an.In the request body, supply a JSON representation of the id of the user object.

POST https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16fec466a82d/reviewers
Content-Type: application/json

{
    "id":"006111db-0810-4494-a6df-904d368bd81b"
}
AntwortResponse

Hinweis: Das hier gezeigte Antwortobjekt wurde möglicherweise zur besseren Lesbarkeit gekürzt. Ein tatsächlicher Aufruf gibt alle Eigenschaften zurück.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 201 Created