accessReviewInstance-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 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. Es gibt eine Entscheidung pro Identität, die überprüft wird.
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 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ü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 NotReviewed accessReviewInstanceDecisionItem zu akzeptieren, für das er der Prüfer für eine bestimmte accessReviewInstance ist. |
applyDecisions | Keine. | Manuelles Anwenden von Entscheidungen auf eine accessReviewInstance. |
stopApplyDecisions | Keine. | Ermöglicht es dem aufrufenden Benutzer, die Entscheidungsaktion anwenden auf eine bestimmte accessReviewInstance zu beenden. |
batchRecordDecisions | Keine | Überprüfen Sie Batches von Prinzipalen oder Ressourcen in einem Aufruf. |
resetDecisions | Keine | Setzt alle Entscheidungselemente eines instance auf zurücknotReviewed . |
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. |
List pendingAccessReviewInstances (veraltet) | accessReviewInstance-Auflistung . | Ruft alle ausstehenden accessReviewInstance-Ressourcen ab, die dem aufrufenden Benutzer zugewiesen sind. Diese Methode ist veraltet und wird durch filterByCurrentUser ersetzt. |
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. |
errors | accessReviewError-Sammlung | Sammlung von Fehlern in einer Zugriffsüberprüfung instance Lebenszyklus. 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 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. |
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. |
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. |
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. |
Definition | accessReviewScheduleDefinition | Jeder instance ist genau eine accessReviewScheduleDefinition zugeordnet. Dies ist der übergeordnete Zeitplan für die instance, bei dem Instanzen für jede Wiederholung einer Überprüfungsdefinition und für jede Gruppe erstellt werden, die von der Definition aus überprüft werden soll. |
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. |
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. |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"@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"
}
],
"contactedReviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewer"
}
]
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für