accessReviewInstance-Ressourcentyp

Namespace: microsoft.graph

Stellt eine Azure AD-Zugriffsüberprüfungsserie dar. Systemgeneriert basierend auf dem übergeordneten accessReviewScheduleDefinition-Objekt . Alle Eigenschaften sind schreibgeschützt.

Wenn die Instanz Teil einer Überprüfung des wiederkehrenden Zugriffs ist, stellen Instanzen jede Serie dar. Eine Überprüfung, die nicht wiederholt wird, weist genau eine Instanz auf. Instanzen stellen auch jede eindeutige Ressource dar, die in der Zeitplandefinition überprüft wird. Wenn eine Terminplandefinition mehrere Ressourcen überprüft, verfügt jede Ressource ü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.

Erbt von entity.

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 Instanzobjekte einer Definition zurück, für die der aufrufende Benutzer der Prüfer 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 Keinen Senden Sie eine Erinnerung an die Bearbeiter einer accessReviewInstance.
stop Keinen Beenden Sie eine accessReviewInstance manuell.
acceptRecommendations Keinen 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 Keinen Manuelles Anwenden einer Entscheidung für eine accessReviewInstance.
batchRecordDecisions Keinen Überprüfen Sie Batches von Prinzipalen oder Ressourcen in einem Aufruf.
resetDecisions Keinen Setzt alle Entscheidungselemente in einer Instanz auf notReviewed
Entscheidungen auflisten accessReviewInstanceDecisionItem-Sammlung Rufen Sie die accessReviewInstanceDecisionItem-Ressourcen aus der Decisions-Navigationseigenschaft ab.

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.
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. Geerbt von entity. 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 String 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
Entscheidungen accessReviewInstanceDecisionItem-Sammlung Jeder in einer accessReviewInstance überprüfte Prinzipal verfügt über ein Entscheidungselement, das angibt, ob sie genehmigt, abgelehnt oder noch nicht überprüft wurden.
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.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.accessReviewInstance",
  "id": "String (identifier)",
  "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"
    }
  ]
}