accessReview-RessourcentypaccessReview resource type

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.

Im Feature Azure AD Access Reviews stellt das accessReview eine Zugriffsüberprüfung dar.In the Azure AD access reviews feature, the accessReview represents an access review.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
AccessReviews auflistenList accessReviews accessReview -SammlungaccessReview collection Auflisten von accessReviews für ein businessFlowTemplate.List accessReviews for a businessFlowTemplate.
AccessReview abrufenGet accessReview accessReviewaccessReview Abrufen einer Zugriffsüberprüfung mit einer bestimmten ID.Get an access review with a specific id.
AccessReview erstellenCreate accessReview accessReviewaccessReview Erstellen Sie eine neue accessReview.Create a new accessReview.
AccessReview aktualisierenUpdate accessReview accessReviewaccessReview Aktualisieren einer accessReview.Update an accessReview.
AccessReview löschenDelete accessReview Keine.None. Löschen eines accessReview.Delete an accessReview.
AccessReview-Prüfer auflistenList accessReview reviewers User Identity -SammlunguserIdentity collection Abrufen der Bearbeiter eines accessReview.Get the reviewers of an accessReview.
AccessReview-Prüfer hinzufügenAdd accessReview reviewer Keine.None. Fügen Sie einen Prüfer zu einem accessReview hinzu.Add a reviewer to an accessReview.
AccessReview-Prüfer entfernenRemove accessReview reviewer Keine.None. Entfernen Sie einen Prüfer aus einer accessReview.Remove a reviewer from an accessReview.
AccessReview-Entscheidungen auflistenList accessReview decisions accessReviewDecision -SammlungaccessReviewDecision collection Abrufen der Entscheidungen eines accessReview.Get the decisions of an accessReview.
Meine accessReview-Entscheidungen auflistenList my accessReview decisions accessReviewDecision -SammlungaccessReviewDecision collection Als Prüfer erhalten Sie meine Entscheidungen eines accessReview.As a reviewer, get my decisions of an accessReview.
AccessReview-Erinnerung sendenSend accessReview reminder Keine.None. Senden Sie eine Erinnerung an die Bearbeiter eines accessReview.Send a reminder to the reviewers of an accessReview.
AccessReview beendenStop accessReview Keine.None. Beenden eines accessReview.Stop an accessReview.
Zurücksetzen von accessReview-EntscheidungenReset accessReview decisions Keine.None. Zurücksetzen der Entscheidungen in einer laufenden accessReview.Reset the decisions in an in-progress accessReview.
Anwenden von accessReview-EntscheidungenApply accessReview decisions Keine.None. Wenden Sie die Entscheidungen von einem abgeschlossenen accessReview.Apply the decisions from a completed accessReview.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
id String Der vom Feature zugewiesene eindeutige Bezeichner einer Zugriffsüberprüfung.The feature-assigned unique identifier of an access review.
displayName String Der Name der Zugriffsüberprüfung.The access review name. Beim Erstellen erforderlich.Required on create.
startDateTime DateTimeOffset Die Uhrzeit, zu der die Überprüfung gestartet werden soll.The DateTime when the review is scheduled to be start. Dies könnte ein Datum in der Zukunft sein.This could be a date in the future. Beim Erstellen erforderlich.Required on create.
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. Beim Erstellen erforderlich.Required on create.
status String Dieses schreibgeschützte Feld gibt den Status eines accessReview an.This read-only field specifies the status of an accessReview. Zu den Initializingtypischen Zuständen gehören Starting,InProgress NotStarted, Completing, Completed, AutoReviewing,, AutoReviewed, und.The typical states include Initializing, NotStarted, Starting,InProgress, Completing, Completed, AutoReviewing, and AutoReviewed.
description String Die vom Zugriffs Überprüfungs Ersteller bereitgestellte Beschreibung, die den Prüfern angezeigt werden soll.The description provided by the access review creator, to show to the reviewers.
businessFlowTemplateId String Der Bezeichner der Geschäfts Fluss Vorlage.The business flow template identifier. Beim Erstellen erforderlich.Required on create.
reviewerType String Der Beziehungstyp des Reviewers für das Zielobjekt, eines von self delegated oder. entityOwnersThe relationship type of reviewer to the target object, one of self, delegated or entityOwners. Beim Erstellen erforderlich.Required on create.
createdBy User IdentityuserIdentity Der Benutzer, der diese Überprüfung erstellt hat.The user who created this review.
reviewedEntity identityidentity Das Objekt, für das die Zugriffsüberprüfungen die Zuordnungen von Zugriffsrechten überprüfen.The object for which the access reviews is reviewing the access rights assignments. Dies kann die Gruppe für die Überprüfung von Mitgliedschaften von Benutzern in einer Gruppe oder die APP für eine Überprüfung der Zuweisungen von Benutzern zu einer Anwendung sein.This can be the group for the review of memberships of users in a group, or the app for a review of assignments of users to an application. Beim Erstellen erforderlich.Required on create.
settings microsoft.graph.accessReviewSettings Die Einstellungen eines accessReview finden Sie unter Type Definition below.The settings of an accessReview, see type definition below.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
reviewers User Identity -SammlunguserIdentity collection Die Auflistung der Bearbeiter für eine Zugriffsüberprüfung, wenn Access Review reviewertype vom Typ delegateist.The collection of reviewers for an access review, if access review reviewerType is of type delegate.
decisions accessReviewDecision -SammlungaccessReviewDecision collection Die Sammlung von Entscheidungen für diese Zugriffsüberprüfung.The collection of decisions for this access review.
myDecisions accessReviewDecision -SammlungaccessReviewDecision collection Die Sammlung von Entscheidungen für den Aufrufer, wenn der Aufrufer ein Prüfer ist.The collection of decisions for the caller, if the caller is a reviewer.
instances accessReview -SammlungaccessReview collection Die Auflistung von Access überprüft Instanzen Vergangenheit, Gegenwart und Zukunft, wenn es sich bei diesem Objekt um eine wiederkehrende Zugriffsüberprüfung handelt.The collection of access reviews instances past, present and future, if this object is a recurring access review.

Ob diese Beziehungen in einem Objekt vorhanden sind, hängt davon ab, ob es sich bei dem Objekt um eine einmalige Zugriffsüberprüfung, die Reihe einer wiederkehrenden Zugriffsüberprüfung oder eine Instanz einer wiederkehrenden Zugriffsüberprüfung handelt.Whether these relationships are present on an object, depends upon whether the object is a one-time access review, the series of a recurring access review, or an instance of a recurring access review.

SzenarioScenario Verfügt Überprüfer?Has reviewers? Gibt es Entscheidungen und mydecisions?Has decisions and myDecisions? Instanzen?Has instances?
Überprüfung des einmaligen ZugriffsOne-time access review JaYes Ja, einmal gestartetYes, once started NeinNo
Überprüfung des wiederkehrenden ZugriffsRecurring access review JaYes NeinNo JaYes
Instanz einer wiederkehrenden ZugriffsüberprüfungInstance of a recurring access review JaYes Ja, einmal gestartetYes, once started NeinNo

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

{
 "id": "string (identifier)",
 "displayName": "string",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "description": "string",
 "businessFlowTemplateId": "string (identifier)",
 "reviewerType": "string",
 "createdBy": "microsoft.graph.userIdentity",
 "reviewedEntity": "microsoft.graph.identity",
 "settings": "microsoft.graph.accessReviewSettings",
 "reviewers": "Collection(microsoft.graph.userIdentity)"
}

Der accessReviewSettings-TypThe accessReviewSettings type

Die accessReviewSettings bietet zusätzliche Einstellungen beim Erstellen einer Zugriffsüberprüfung, um das Feature-Verhalten beim Starten einer Zugriffsüberprüfung zu steuern.The accessReviewSettings provides additional settings when creating an access review, to control the feature behavior when starting an access review. Dieser Typ verfügt über die folgenden Eigenschaften:This type has the following properties:

EigenschaftProperty TypType BeschreibungDescription
mailNotificationsEnabled Boolean Kennzeichen, um anzugeben, ob das Senden von e-Mails an Prüfer und der Überprüfungs Ersteller aktiviert ist.Flag to indicate whether sending mails to reviewers and the review creator is enabled.
remindersEnabled Boolean Kennzeichen, um anzugeben, ob das Senden von Erinnerungs-e-Mails an Prüfer aktiviert ist.Flag to indicate whether sending reminder emails to reviewers are enabled.
justificationRequiredOnApproval Boolean Kennzeichen, um anzugeben, ob Bearbeiter bei der Überprüfung des Zugriffs eine Begründung vorsehen müssen.Flag to indicate whether reviewers are required to provide a justification when reviewing access.
activityDurationInDays Int64 Die Anzahl der Tage der Benutzeraktivitäten, die den Prüfern angezeigt werden sollen.The number of days of user activities to show to reviewers.
autoReviewEnabled Boolean Kennzeichen, um anzugeben, ob das Feature eine Entscheidung treffen sollte, wenn der Bearbeiter keines angegeben hat, für die Verwendung mit Auto-Apply ist aktiviert.Flag to indicate whether the feature should set a decision if the reviewer did not supply one, for use with auto-apply, is enabled.
autoReviewSettings microsoft.graph.autoReviewSettings Detaillierte Einstellungen dafür, wie das Feature die Überprüfungs Entscheidung für die Verwendung mit Auto-Apply festlegen sollte, die nachfolgend beschrieben wird.Detailed settings for how the feature should set the review decision, for use with auto-apply, described below.
recurrenceSettings microsoft.graph.accessReviewRecurrenceSettings Detaillierte Einstellungen für Serie, die weiter unten beschrieben werden.Detailed settings for recurrence, described below.
autoApplyReviewResultsEnabled Boolean Kennzeichen, um anzugeben, ob die Funktion automatisch anwenden zum automatischen Ändern der Zielobjekt Zugriffs Ressource aktiviert ist.Flag to indicate whether auto-apply capability, to automatically change the target object access resource, is enabled. Wenn diese Option nicht aktiviert ist, muss der Benutzer nach Abschluss der Überprüfung die Zugriffsüberprüfung anwenden.If not enabled, a user must, after the review completes, apply the access review.
accessRecommendationsEnabled Boolean Kennzeichen, um anzugeben, ob Empfehlungen für Prüfer aktiviert sind.Flag to indicate whether showing recommendations to reviewers is enabled.

Der autoReviewSettings-TypThe autoReviewSettings type

Das autoReviewSettings ist in die Einstellungen für die Zugriffsüberprüfung eingebettet und gibt das Verhalten für das Feature an, wenn eine Zugriffsüberprüfung abgeschlossen wird.The autoReviewSettings is embedded within the access review settings, and specifies the behavior for the feature when an access review completes. Der Typ verfügt über eine Eigenschaft notReviewedResult,.The type has one property, notReviewedResult.

EigenschaftProperty TypType BeschreibungDescription
notReviewedResult String Muss Approve, Deny oder Recommendation sein.Must be one of Approve, Deny, or Recommendation.

Der accessReviewRecurrenceSettings-TypThe accessReviewRecurrenceSettings type

Das accessReviewRecurrenceSettings ist in die Einstellungen für die Zugriffsüberprüfung eingebettet und gibt an, dass die Zugriffsüberprüfung in regelmäßigen Intervallen wiederholt wird.The accessReviewRecurrenceSettings is embedded within the access review settings, and specifies that the access review recurs at regular intervals. Dieser Typ verfügt über die folgenden Eigenschaften:This type has the following properties:

EigenschaftProperty TypType BeschreibungDescription
recurrenceType String Das Serienintervall, das onetimeeine von, weekly, monthly, quarterlyoder annualsein muss.The recurrence interval, which must be one of onetime, weekly, monthly, quarterly, or annual.
recurrenceEndType String Wie die Serie endet.How the recurrence ends. Wenn dies der NeverFall ist, gibt es kein explizites Ende der Serien Reihe.If it is Never, then there is no explicit end of the recurrence series. Wenn dies der endByFall ist, endet die Serie an einem bestimmten Datum.If it is endBy, then the recurrence ends at a certain date. Wenn dies der occurrencesFall ist, endet die Daten recurrentCount Reihe, nachdem Instanzen der Überprüfung abgeschlossen wurden.If it is occurrences, then the series ends after recurrentCount instances of the review have completed.
durationInDays Int32 Die Dauer in Tagen für die Serie.The duration in days for recurrence.
recurrenceCount Int32 Die Anzahl der Wiederholungen, wenn der Wert von recurrenceEndType ist occurrences, oder 0 andernfalls.The count of recurrences, if the value of recurrenceEndType is occurrences, or 0 otherwise.