Freigeben über


accessReviewStage-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Hinweis

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

Stellt eine Phase einer Microsoft Entra Zugriffsüberprüfungsserie dar. Wenn das übergeordnete accessReviewScheduleDefinition die stageSettings-Eigenschaft definiert hat, besteht accessReviewInstance aus bis zu drei nachfolgenden Phasen. Jede Phase kann über einen anderen Satz von Prüfern verfügen, die auf die Phasenentscheidungen reagieren können, und über Einstellungen, die bestimmen, welche Entscheidungen von Phase zu Phase übergeben werden.

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

Methoden

Methode Rückgabetyp Beschreibung
List accessReviewStage-Sammlung Rufen Sie eine Liste der accessReviewStage-Objekte und deren Eigenschaften ab.
Get accessReviewStage Liest die Eigenschaften und Beziehungen eines accessReviewStage-Objekts .
Update accessReviewStage Aktualisiert die Eigenschaften eines accessReviewStage-Objekts .
Stop Keine Beenden Sie accessReviewStage manuell.
Nach aktuellem Benutzer filtern accessReviewStage-Sammlung Gibt alle Phasen einer bestimmten accessReviewInstance zurück, für die der aufrufende Benutzer prüfer ist.
Auflisten von Entscheidungen aus einer Phase eines instance accessReviewInstanceDecisionItem-Auflistung Abrufen der In accessReviewStage getroffenen Entscheidungen.

Eigenschaften

Eigenschaft Typ Beschreibung
endDateTime DateTimeOffset DateTime, wenn das Ende der Überprüfungsphase 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. Diese Eigenschaft ist die kumulierte Summe der durationInDays für alle Phasen. 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 liste der angegebenen Prüfer keine Benutzer gefunden werden. Dies kann der Fall sein, 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.
id Zeichenfolge Eindeutiger Bezeichner der Phase. Schreibgeschützt.
Bewertungen accessReviewReviewerScope-Sammlung Diese Sammlung von Zugriffsüberprüfungsbereichen wird verwendet, um zu definieren, wer die Prüfer sind. 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.
startDateTime DateTimeOffset DateTime, wenn die Überprüfungsphase gestartet werden soll. 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. Schreibgeschützt.
status Zeichenfolge Gibt die status einer accessReviewStage an. Mögliche Werte: Initializing, NotStarted, Starting, InProgress, Completing, Completed, AutoReviewingund AutoReviewed. Unterstützt $orderby, und $filter (eq nur). Schreibgeschützt.

Beziehungen

Beziehung Typ Beschreibung
Entscheidungen accessReviewInstanceDecisionItem-Auflistung Jeder In accessReviewStage überprüfte Benutzer verfügt über ein Entscheidungselement, das angibt, ob er genehmigt, verweigert oder noch nicht überprüft wurde.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.accessReviewStage",
  "id": "String (identifier)",
  "startDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "status": "String",
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ]
}