accessReview-Ressourcentyp (veraltet)
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.
Achtung
Diese Version der Zugriffsüberprüfungs-API ist veraltet und gibt am 19. Mai 2023 keine Daten mehr zurück. Verwenden Sie die Zugriffsüberprüfungs-API.
Stellt eine Microsoft Entra-Zugriffsüberprüfung dar.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Auflisten von Zugriffsüberprüfungen | accessReview-Sammlung | Auflisten von accessReviews für ein businessFlowTemplate-Objekt. |
| Zugriffsüberprüfung abrufen | accessReview | Rufen Sie eine Zugriffsüberprüfung mit einer bestimmten ID ab. |
| Zugriffsüberprüfung erstellen | accessReview | Erstellen Sie eine neue accessReview. |
| Zugriffsüberprüfung aktualisieren | accessReview | Aktualisieren sie eine accessReview. |
| Zugriffsüberprüfung löschen | Keine. | Löschen sie eine accessReview.Delete an accessReview. |
| Bearbeiter auflisten | userIdentity-Sammlung | Rufen Sie die Prüfer einer accessReview ab. |
| Bearbeiter hinzufügen | Keine. | Fügen Sie einer accessReview einen Prüfer hinzu. |
| Bearbeiter entfernen | Keine. | Entfernen sie einen Prüfer aus einer accessReview. |
| Entscheidungen auflisten | accessReviewDecision-Sammlung | Rufen Sie die Entscheidungen einer accessReview ab. |
| Meine Entscheidungen auflisten | accessReviewDecision-Sammlung | Als Prüfer können Sie meine Entscheidungen über eine accessReview abrufen. |
| Erinnerung senden | Keine. | Senden Sie eine Erinnerung an die Prüfer einer accessReview. |
| Stop | Keine. | Beenden Sie eine accessReview. |
| Reset | Keine. | Setzen Sie die Entscheidungen in einer laufenden accessReview zurück. |
| Anwenden von Entscheidungen | Keine. | Wenden Sie die Entscheidungen aus einer abgeschlossenen accessReview an. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | Zeichenfolge | Der featureseitig zugewiesene eindeutige Bezeichner einer Zugriffsüberprüfung. |
| displayName | Zeichenfolge | Der Name der Zugriffsüberprüfung. Beim Erstellen erforderlich. |
| startDateTime | DateTimeOffset | Das Datum und die Uhrzeit, zu dem die Überprüfung gestartet werden soll. Dieses Datum kann in der Zukunft sein. Beim Erstellen erforderlich. |
| endDateTime | DateTimeOffset | Der DateTime-Wert, wenn das Ende der Überprüfung geplant ist. Dies muss mindestens einen Tag nach dem Startdatum erfolgen. Beim Erstellen erforderlich. |
| status | Zeichenfolge | Dieses schreibgeschützte Feld gibt den Status einer accessReview an. Die typischen Zustände sind Initializing, , StartingNotStarted,InProgressCompleting , , CompletedAutoReviewingund AutoReviewed. |
| description | Zeichenfolge | Die Vom Ersteller der Zugriffsüberprüfung bereitgestellte Beschreibung, die den Prüfern angezeigt werden soll. |
| businessFlowTemplateId | Zeichenfolge | Der Bezeichner der Geschäftsflussvorlage. Beim Erstellen erforderlich. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet. |
| reviewerType | Zeichenfolge | Der Beziehungstyp des Prüfers zum Zielobjekt, eine der folgenden: self, delegated, entityOwners. Beim Erstellen erforderlich. |
| createdBy | userIdentity | Der Benutzer, der diese Überprüfung erstellt hat. |
| reviewEntity | identity | Das Objekt, für das die Zugriffsüberprüfung die Zugriffsrechtezuweisungen überprüft. Diese Identität kann die Gruppe für die Überprüfung der Mitgliedschaften von Benutzern in einer Gruppe oder die App für eine Überprüfung der Zuweisungen von Benutzern zu einer Anwendung sein. Beim Erstellen erforderlich. |
| settings | accessReviewSettings | Die Einstellungen einer accessReview finden Sie weiter unten in der Typdefinition. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| rezensenten | userIdentity-Sammlung | Die Sammlung von Prüfern für eine Zugriffsüberprüfung, wenn access reviewerType vom Typ delegatedist. |
| Entscheidungen | accessReviewDecision-Sammlung | Die Sammlung von Entscheidungen für diese Zugriffsüberprüfung. |
| myDecisions | accessReviewDecision-Sammlung | Die Sammlung von Entscheidungen für den Aufrufer, wenn der Aufrufer ein Prüfer ist. |
| instances | accessReview-Sammlung | Die Auflistung von Zugriffsüberprüfungsinstanzen für vergangene, aktuelle und zukünftige Instanzen, wenn es sich bei diesem Objekt um eine wiederkehrende Zugriffsüberprüfung handelt. |
Ob diese Beziehungen für ein Objekt vorhanden sind, hängt davon ab, ob das Objekt eine einmalige Zugriffsüberprüfung, die Reihe einer wiederkehrenden Zugriffsüberprüfung oder eine Instanz einer wiederkehrenden Zugriffsüberprüfung ist.
| Szenario | Gibt es Prüfer? | Gibt es Entscheidungen und myDecisions? | Gibt es Instanzen? |
|---|---|---|---|
| Einmalige Zugriffsüberprüfung | Ja | Ja, einmal gestartet | Nein |
| Wiederkehrende Zugriffsüberprüfung | Ja | Nein | Ja |
| Instanz einer wiederkehrenden Zugriffsüberprüfung | Ja | Ja, einmal gestartet | Nein |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"id": "string (identifier)",
"displayName": "string",
"startDateTime": "string (timestamp)",
"endDateTime": "string (timestamp)",
"status": "string",
"description": "string",
"businessFlowTemplateId": "string (identifier)",
"reviewerType": "string",
"createdBy": {"@odata.type": "microsoft.graph.userIdentity"},
"reviewedEntity": {"@odata.type": "microsoft.graph.identity"},
"settings": {"@odata.type": "microsoft.graph.accessReviewSettings"},
"reviewers": [{"@odata.type": "microsoft.graph.userIdentity"}]
}