AccessReview aktualisierenUpdate accessReview

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 eine oder mehrere seiner Eigenschaften zu ändern.In the Azure AD access reviews feature, update an existing accessReview object to change one or more of its properties.

Diese API dient nicht zum Ändern der Bearbeiter oder der Entscheidungen einer Überprüfung.This API is not intended to change the reviewers or decisions of a review. Verwenden Sie zum Ändern der Bearbeiter die addreviewer-oder removeReviewer -APIs.To change the reviewers, use the addReviewer or removeReviewer APIs. Wenn Sie eine bereits begonnene einmalige Überprüfung oder eine bereits gestartete Instanz einer wiederkehrenden Überprüfung vorzeitig beenden möchten, verwenden Sie die Stop -API.To stop an already-started one-time review, or an already-started instance of a recurring review, early, use the stop API. Verwenden Sie die Apply -API, um die Entscheidungen auf die Zielgruppen-oder App-Zugriffsrechte anzuwenden.To apply the decisions to the target group or app access rights, use the apply API.

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

PATCH /accessReviews/{reviewId}

AnforderungsheaderRequest headers

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

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter eines accessReview -Objekts an.In the request body, supply a JSON representation of the parameters of an accessReview object.

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
displayName String Der Name der Zugriffsüberprüfung.The access review name.
startDateTime DateTimeOffset Die Uhrzeit, zu der die Überprüfung gestartet werden soll.The DateTime when the review is scheduled to be start. Dies muss ein Datum in der Zukunft sein.This must be a date in the future.
endDateTime DateTimeOffset Die Uhrzeit, zu der die Überprüfung enden soll.The DateTime when the review is scheduled to end. Dies muss mindestens einen Tag nach dem Startdatum liegen.This must be at least one day later than the start date.
description String Die Beschreibung, die den Prüfern angezeigt werden soll.The description, to show to the reviewers.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 204, Accepted werden der Antwortcode und ein accessReview -Objekt im Antworttext zurückgegeben.If successful, this method returns a 204, Accepted response code and an accessReview object in the response body.

BeispielExample

Dies ist ein Beispiel für die Aktualisierung einer einmaligen (nicht wiederkehrenden) Zugriffsüberprüfung.This is an example of updating a one-time (not reoccurring) access review.

AnforderungRequest

Geben Sie im Anforderungstext eine JSON-Darstellung der neuen Eigenschaften des accessReview -Objekts an.In the request body, supply a JSON representation of the new properties of the accessReview object.

PATCH https://graph.microsoft.com/beta/accessReviews/006111db-0810-4494-a6df-904d368bd81b
Content-type: application/json

{
    "displayName":"TestReview new name"
}
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 204 Accepted
Content-type: application/json

{
    "id": "006111db-0810-4494-a6df-904d368bd81b",
    "displayName": "TestReview new name",
    "startDateTime": "2017-02-10T00:35:53.214Z",
    "endDateTime": "2017-03-12T00:35:53.214Z",
    "status": "Initializing",
    "businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
    "reviewerType": "delegated",
    "description": "Sample description"
}