accessReviewInstance-Ressourcentyp

Artikel
04/09/2024

Namespace: microsoft.graph

Stellt eine Microsoft Entra Zugriffsüberprüfungsserie dar. Wenn das übergeordnete accessReviewScheduleDefinition-Element eine wiederkehrende Zugriffsüberprüfung ist, stellen Instanzen jede Wiederholung dar. Eine Überprüfung, die nicht wiederholt wird, weist genau eine instance auf. Instanzen stellen auch jede eindeutige Gruppe dar, die in der Zeitplandefinition überprüft wird. Wenn eine Zeitplandefinition mehrere Gruppen überprüft, verfügt jede Gruppe über einen eindeutigen instance für jede Wiederholung.

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

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
AccessReviewInstances auflisten	accessReviewInstance-Sammlung	Ruft eine Liste der accessReviewInstance-Objekte und deren Eigenschaften ab.
Get accessReviewInstance	accessReviewInstance	Liest die Eigenschaften und Beziehungen eines accessReviewInstance-Objekts .
Aktualisieren von accessReviewInstance	accessReviewInstance	Aktualisieren sie die Prüfer eines accessReviewInstance-Objekts .
filterByCurrentUser	accessReviewInstance-Sammlung	Gibt alle Instanzen einer angegebenen 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üfung instance erhalten haben.
sendReminder	Keine	Senden Sie eine Erinnerung an die Prüfer einer accessReviewInstance.
stop	Keine	Beenden Sie eine accessReviewInstance manuell.
acceptRecommendations	Keine	Ermöglicht es dem aufrufenden Benutzer, die Entscheidungsempfehlung für jedes accessReviewInstanceDecisionItem-Objekt zu akzeptieren, das als `NotReviewed` markiert ist und für das der Aufrufer ein Prüfer der zugeordneten accessReviewInstance ist.
applyDecisions	Keine	Manuelles Anwenden von Entscheidungen auf eine accessReviewInstance.
batchRecordDecisions	Keine	Überprüfen Sie Batches von Prinzipalen oder Ressourcen in einem Aufruf.
resetDecisions	Keine	Setzt alle Entscheidungselemente eines instance auf zurück`notReviewed`.
Phasen auflisten	accessReviewStage-Sammlung	Rufen Sie die Phasen in einer mehrstufigen Zugriffsüberprüfung instance ab.
Entscheidungen auflisten	accessReviewInstanceDecisionItem-Auflistung	Rufen Sie die accessReviewInstanceDecisionItem-Ressourcen aus der Navigationseigenschaft decisions ab.

Eigenschaften

Eigenschaft	Typ	Beschreibung
endDateTime	DateTimeOffset	DateTime, wenn das Ende instance geplant ist. Der DatetimeOffset-Typ stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`. Unterstützt `$select`. Schreibgeschützt.
fallbackReviewers	accessReviewReviewerScope-Sammlung	Diese Sammlung von Prüferbereichen wird verwendet, um die Liste der Fallbackprüfer zu definieren. Diese Fallbackprüfer werden benachrichtigt, maßnahmen zu ergreifen, wenn in der angegebenen Liste der Prüfer keine Benutzer gefunden werden. Dies kann auftreten, wenn entweder der Gruppenbesitzer als Prüfer angegeben wird, der Gruppenbesitzer aber nicht vorhanden ist, oder wenn der Vorgesetzte eines Benutzers als Prüfer angegeben wird, der Vorgesetzte eines Benutzers jedoch nicht vorhanden ist. Unterstützt `$select`.
id	String	Eindeutiger Bezeichner des instance. Unterstützt `$select`. Schreibgeschützt.
Bewertungen	accessReviewReviewerScope-Sammlung	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 Prüfern finden Sie unter Zuweisen von Prüfern zu Ihrer Zugriffsüberprüfungsdefinition mithilfe der Microsoft Graph-API.
Bereich	accessReviewScope	Wird basierend auf scope und instanceEnumerationScope auf accessReviewScheduleDefinition-Ebene erstellt. Definiert den Bereich der Benutzer, die in einer Gruppe überprüft werden. Unterstützt `$select` und `$filter` (`contains` nur). Schreibgeschützt.
startDateTime	DateTimeOffset	DateTime, wenn die Überprüfung instance geplant ist. Kann in der Zukunft sein. 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	String	Gibt die status einer accessReview an. Mögliche Werte: `Initializing`, `NotStarted`, `Starting`, `InProgress`, `Completing`, `Completed`, `AutoReviewing`und `AutoReviewed`. Unterstützt `$select`, `$orderby`und `$filter` (`eq` nur). Schreibgeschützt.

Beziehungen

Beziehung	Typ	Beschreibung
contactedReviewers	accessReviewReviewer-Sammlung	Gibt die Auflistung der Prüfer zurück, die kontaktiert wurden, um diese Überprüfung abzuschließen. Während die Reviewer - 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.
Entscheidungen	accessReviewInstanceDecisionItem-Auflistung	Jeder Benutzer, der in einer accessReviewInstance überprüft wird, verfügt über ein Entscheidungselement, das angibt, ob er genehmigt, verweigert oder noch nicht überprüft wurde.
stages	accessReviewStage-Sammlung	Wenn die instance über mehrere Phasen verfügt, wird die Auflistung der Phasen zurückgegeben. Eine neue Phase wird nur erstellt, wenn die vorherige Phase endet. Das Vorhandensein, die Anzahl und die Einstellungen von Phasen in einem Überprüfungs-instance werden basierend auf accessReviewStageSettings für das übergeordnete accessReviewScheduleDefinition-Element erstellt.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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