accessReviewInstance-RessourcentypaccessReviewInstance resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert 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. Verwenden Sie die Versionsauswahl, um zu ermitteln, ob eine API in Version 1.0 verfügbar ist.To determine whether an API is available in v1.0, use the Version selector.

Stellt eine Wiederholung der Azure AD-Zugriffsüberprüfung dar.Represents an Azure AD access review recurrence. Wenn es sich bei der übergeordneten accessReviewScheduleDefinition um eine wiederkehrende Zugriffsüberprüfung handelt, stellen Instanzen jede Serie dar.If the parent accessReviewScheduleDefinition is a recurring access review, instances represent each recurrence. Eine Überprüfung, die nicht erneut vor sich geht, hat genau eine Instanz.A review that does not recur will have exactly one instance. Instanzen stellen auch jede eindeutige Gruppe dar, die in der Zeitplandefinition überprüft wird.Instances also represent each unique group being reviewed in the schedule definition. Wenn eine Zeitplandefinition mehrere Gruppen überprüft, hat jede Gruppe eine eindeutige Instanz für jede Serie.If a schedule definition reviews multiple groups, each group will have a unique instance for each recurrence.

Jede accessReviewInstance enthält eine Liste von Entscheidungen, für die Prüfer Maßnahmen ergreifen können.Every accessReviewInstance contains a list of decisions that reviewers can take action on. Es wird eine Entscheidung pro Identität überprüft.There is one decision per identity being reviewed.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
AccessReviewInstances auflistenList accessReviewInstances accessReviewInstance-SammlungaccessReviewInstance collection Hier erhalten Sie eine Liste der accessReviewInstance-Objekte und deren Eigenschaften.Get a list of the accessReviewInstance objects and their properties.
AccessReviewInstance erhaltenGet accessReviewInstance accessReviewInstanceaccessReviewInstance Gibt accessReviewInstance für eine accessReviewScheduleDefinition zurück.Returns accessReviewInstance for an accessReviewScheduleDefinition. Enthält keine zugeordneten accessReviewInstanceDecisionItem-Objekte in das Objekt.Does not include associated accessReviewInstanceDecisionItem`s in the object.
Auflisten von "pendingAccessReviewInstances"List pendingAccessReviewInstances accessReviewInstance-Auflistung.accessReviewInstance collection. Ruft alle ausstehenden accessReviewInstance-Ressourcen ab, die dem aufrufenden Benutzer zugewiesen sind.Get all pending accessReviewInstance resources assigned to the calling user.
"accessReviewInstance"-Erinnerung sendenSend accessReviewInstance reminder Keine.None. Senden Sie eine Erinnerung an die Prüfer einer accessReviewInstance.Send a reminder to the reviewers of an accessReviewInstance.
accessReviewInstance beendenStop accessReviewInstance Keine.None. Beenden Sie eine accessReviewInstance manuell.Manually stop an accessReviewInstance.
Akzeptieren von EmpfehlungenAccept recommendations Keine.None. Ermöglicht dem aufrufenden Benutzer, die Entscheidungsempfehlung für jedes "NotReviewInstanceDecisionItem" zu akzeptieren, auf dem er für eine bestimmte accessReviewInstance der Prüfer ist.Allows the calling user to accept the decision recommendation for each NotReviewed accessReviewInstanceDecisionItem that they are the reviewer on for a specific accessReviewInstance.
Anwenden von EntscheidungenApply decisions Keine.None. Manuelles Anwenden einer Entscheidung für eine accessReviewInstance.Manually apply decision on an accessReviewInstance.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
idid StringString Eindeutiger Bezeichner der Instanz.Unique identifier of the instance.
displayNamedisplayName StringString Name der übergeordneten accessReviewScheduleDefinition.Name of the parent accessReviewScheduleDefinition.
startDateTimestartDateTime DateTimeOffsetDateTimeOffset DateTime, wenn der Start der Überprüfungsinstanz geplant ist.DateTime when review instance is scheduled to start. Möglicherweise in der Zukunft.May be in the future.
endDateTimeendDateTime DateTimeOffsetDateTimeOffset DateTime, wenn das Ende der Überprüfungsinstanz geplant ist.DateTime when review instance is scheduled to end.
statusstatus Zeichenfolgestring Gibt den Status einer accessReview an.Specifies the status of an accessReview. Die typischen Zustände sind Initializing , , , , , und NotStarted Starting InProgress Completing Completed AutoReviewing AutoReviewed .The typical states include Initializing, NotStarted, Starting, InProgress, Completing, Completed, AutoReviewing, and AutoReviewed. Schreibgeschützt.Read-only.
scopescope accessReviewScopeaccessReviewScope Erstellt basierend auf Bereich und instanceEnumerationScope auf der AccessReviewScheduleDefinition-Ebene.Created based on scope and instanceEnumerationScope at the accessReviewScheduleDefinition level. Definiert den Bereich der in einer Gruppe überprüften Benutzer.Defines the scope of users reviewed in a group. Bei einer Einzelgruppenüberprüfung gilt der auf dieser Ebene definierte Bereich accessReviewScheduleDefinition für alle Instanzen.In the case of a single-group review, the scope defined at the accessReviewScheduleDefinition level applies to all instances. Bei der Überprüfung aller Gruppen kann der Bereich für jede Gruppe unterschiedlich sein.In the case of all groups review, scope may be different for each group. Schreibgeschützt.Read-only.
Entscheidungendecisions accessReviewInstanceDecisionItem-SammlungaccessReviewInstanceDecisionItem collection Jeder Benutzer, der in einer accessReviewInstance überprüft wurde, verfügt über ein Entscheidungselement, das darstellt, ob der Zugriff genehmigt, verweigert oder noch nicht überprüft wurde.Each user reviewed in an accessReviewInstance has a decision item representing if their access was approved, denied, or not yet reviewed.
definitiondefinition accessReviewScheduleDefinitionaccessReviewScheduleDefinition Jeder Instanz ist genau eine accessReviewScheduleDefinition zugeordnet.There is exactly one accessReviewScheduleDefinition associated with each instance. Es handelt sich um den übergeordneten Zeitplan für die Instanz, in dem Instanzen für jede Wiederholung einer Überprüfungsdefinition und für jede gruppe, die durch die Definition überprüft werden soll, erstellt werden.It is the parent schedule for the instance, where instances are created for each recurrence of a review definition and each group selected to review by the definition.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
definition accessReviewScheduleDefinitionaccessReviewScheduleDefinition Jeder Instanz ist accessReviewScheduleDefinition genau eine zugeordnet.There is exactly one accessReviewScheduleDefinition associated with each instance. Es handelt sich um den übergeordneten Zeitplan für die Instanz, in dem Instanzen für jede Wiederholung einer Überprüfungsdefinition und für jede gruppe, die durch die Definition überprüft werden soll, erstellt werden.It is the parent schedule for the instance, where instances are created for each recurrence of a review definition and each group selected to review by the definition.
decisions accessReviewInstanceDecisionItem-SammlungaccessReviewInstanceDecisionItem collection Jeder in einem Benutzer überprüfte Benutzer verfügt über ein Entscheidungselement, das darstellt, ob er genehmigt, abgelehnt accessReviewInstance oder noch nicht überprüft wurde.Each user reviewed in an accessReviewInstance has a decision item representing if they were approved, denied, or not yet reviewed.

JSON-DarstellungJSON representation

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

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "id": "string (identifier)",
 "displayName": "string",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  }
}