accessReviewInstance-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Hinweis

Dies ist die empfohlene API für Zugriffsüberprüfungen. Die vorherige Version der Zugriffsüberprüfungs-API ist veraltet.

Stellt eine Azure AD-Zugriffsüberprüfungsserie dar. Wenn der übergeordnete AccessReviewScheduleDefinition eine wiederkehrende Zugriffsüberprüfung ist, stellen Instanzen jede Serie dar. Eine Überprüfung, die nicht wiederholt wird, weist genau eine Instanz auf. Instanzen stellen auch jede eindeutige Gruppe dar, die in der Zeitplandefinition überprüft wird. Wenn eine Terminplandefinition mehrere Gruppen überprüft, verfügt jede Gruppe über eine eindeutige Instanz für jede Serie.

Jede accessReviewInstance enthält eine Liste von Entscheidungen , für die Prüfer Maßnahmen ergreifen können. Es gibt eine Entscheidung pro überprüfter Identität.

Methoden

Methode	Rückgabetyp	Beschreibung
accessReviewInstances auflisten	accessReviewInstance-Sammlung	Dient zum Abrufen einer Liste der accessReviewInstance-Objekte und deren Eigenschaften.
AccessReviewInstance abrufen	accessReviewInstance	Lesen sie die Eigenschaften und Beziehungen eines accessReviewInstance-Objekts .
AccessReviewInstance aktualisieren	accessReviewInstance	Aktualisieren Sie die Bearbeiter eines accessReviewInstance-Objekts .
filterByCurrentUser	accessReviewInstance-Sammlung	Gibt alle Instanzen für eine bestimmte accessReviewScheduleDefinition zurück, für die der aufrufende Benutzer der Prüfer einer oder mehrerer Entscheidungen ist.
Auflisten der kontaktierten Prüfer	accessReviewReviewer-Sammlung	Rufen Sie die Prüfer ab, die Benachrichtigungen für eine Zugriffsüberprüfungsinstanz erhalten haben.
sendReminder	Keine.	Senden Sie eine Erinnerung an die Bearbeiter einer accessReviewInstance.
stop	Keine.	Beenden Sie eine accessReviewInstance manuell.
acceptRecommendations	Keine.	Ermöglicht dem aufrufenden Benutzer, die Entscheidungsempfehlung für jedes NotReviewed accessReviewInstanceDecisionItem zu akzeptieren, für das er der Prüfer für eine bestimmte accessReviewInstance ist.
applyDecisions	Keine.	Manuelles Anwenden von Entscheidungen für eine accessReviewInstance.
batchRecordDecisions	Keinen	Überprüfen Sie Batches von Prinzipalen oder Ressourcen in einem Aufruf.
resetDecisions	Keinen	Setzt alle Entscheidungselemente einer Instanz auf notReviewedzurück.
Phasen auflisten	accessReviewStage-Sammlung	Rufen Sie die Phasen in einer mehrstufigen Zugriffsüberprüfungsinstanz ab.
Entscheidungen auflisten	accessReviewInstanceDecisionItem-Sammlung	Rufen Sie die accessReviewInstanceDecisionItem-Ressourcen aus der Decisions-Navigationseigenschaft ab.
Auflisten von pendingAccessReviewInstances (veraltet)	accessReviewInstance-Auflistung .	Ruft alle ausstehenden accessReviewInstance-Ressourcen ab, die dem aufrufenden Benutzer zugewiesen sind. Diese Methode wird veraltet und durch filterByCurrentUser ersetzt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
endDateTime	DateTimeOffset	DateTime, wenn das Ende der Überprüfungsinstanz geplant ist. Der DatetimeOffset-Typ stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Unterstützt $select. Schreibgeschützt.
errors	accessReviewError-Auflistung	Auflistung von Fehlern in einem Instanzlebenszyklus einer Zugriffsüberprüfung. Schreibgeschützt.
fallbackReviewers	accessReviewReviewerScope-Auflistung	Diese Sammlung von Bearbeiterbereichen wird verwendet, um die Liste der Fallbackprüfer zu definieren. Diese Fallbackprüfer werden benachrichtigt, um Maßnahmen zu ergreifen, wenn keine Benutzer aus der angegebenen Liste der Prüfer gefunden werden. Dies kann auftreten, wenn entweder der Gruppenbesitzer als Prüfer angegeben ist, der Gruppenbesitzer jedoch nicht vorhanden ist, oder der Manager als Prüfer angegeben wird, aber der Vorgesetzte eines Benutzers nicht vorhanden ist. Unterstützt $select.
id	Zeichenfolge	Eindeutiger Bezeichner der Instanz. Unterstützt $select. Schreibgeschützt.
scope	accessReviewScope	Erstellt basierend auf bereich und instanceEnumerationScope auf der accessReviewScheduleDefinition-Ebene. Definiert den Umfang der in einer Gruppe überprüften Benutzer. Unterstützt $select und $filter (contains nur). Schreibgeschützt.
startDateTime	DateTimeOffset	DateTime, wenn der Start der Überprüfungsinstanz geplant ist. Möglicherweise in der Zukunft. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Unterstützt $select. Schreibgeschützt.
status	Zeichenfolge	Gibt den Status einer accessReview an. Mögliche Werte: Initializing, , NotStarted, InProgress``Starting, Completing, Completed``AutoReviewingund AutoReviewed. Unterstützt $select, $orderbyund $filter (eq nur). Schreibgeschützt.
Bewertungen	accessReviewReviewerScope-Auflistung	Diese Sammlung von Zugriffsüberprüfungsbereichen wird verwendet, um zu definieren, wer die Prüfer sind. Unterstützt $select. Beispiele für Optionen zum Zuweisen von Bearbeitern finden Sie unter Zuweisen von Prüfern zu Ihrer Zugriffsüberprüfungsdefinition mithilfe der Microsoft Graph-API.

Beziehungen

Beziehung	Typ	Beschreibung
contactedReviewers	accessReviewReviewer-Sammlung	Gibt die Sammlung von Bearbeitern zurück, die kontaktiert wurden, um diese Überprüfung abzuschließen. Während die Bearbeiter - und FallbackReviewers-Eigenschaften von accessReviewScheduleDefinition Gruppenbesitzer oder Manager als Prüfer angeben können, gibt contactedReviewers ihre individuellen Identitäten zurück. Unterstützt $select. Schreibgeschützt.
Definition	accessReviewScheduleDefinition	Jeder Instanz ist genau eine accessReviewScheduleDefinition zugeordnet. Es ist der übergeordnete Zeitplan für die Instanz, in dem Instanzen für jede Serie einer Überprüfungsdefinition und jede Gruppe erstellt werden, die von der Definition überprüft werden soll.
stages	accessReviewStage-Sammlung	Wenn die Instanz mehrere Phasen aufweist, wird die Auflistung von Phasen zurückgegeben. Eine neue Phase wird nur erstellt, wenn die vorherige Phase endet. Das Vorhandensein, die Anzahl und die Einstellungen von Phasen in einer Überprüfungsinstanz werden basierend auf den accessReviewStageSettings im übergeordneten AccessReviewScheduleDefinition erstellt.
Entscheidungen	accessReviewInstanceDecisionItem-Sammlung	Jeder in einer accessReviewInstance überprüfte Benutzer verfügt über ein Entscheidungselement, das angibt, ob er genehmigt, abgelehnt oder noch nicht überprüft wurde.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "id": "string (identifier)",
 "displayName": "string",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "contactedReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewer"
    }
  ]
}