unifiedRoot-Ressourcentyp

Namespace: microsoft.graph

Containerressource, die die einheitlichen Zugriffsüberprüfungssammlungen unter dem identityGovernance/accessReviews/unified Pfadsegment gruppiert. Die unified Route ist der Einstiegspunkt für benutzerzentrierte (katalogbezogene) Zugriffsüberprüfungen, bei denen ein Administrator den Zugriff eines Benutzers auf alle in einem Berechtigungsverwaltungskatalog enthaltenen Ressourcen in einer einzigen Überprüfung überprüft, anstatt jeweils eine Ressource zu überprüfen.

Ein Katalog ist ein Container, der mehrere Ressourcentypen gruppiert – derzeit Gruppen und Anwendungen. Bei einer benutzerzentrierten Überprüfung bewertet ein Prüfer (in der Regel der Manager des Benutzers) den Zugriff eines Prinzipals auf jede Gruppe und Anwendung im Katalog aus einer einzigen, konsolidierten Ansicht. Die Sammlungen verwenden die gleichen Ressourcen-Shapes accessReviewScheduleDefinition, accessReviewInstance und accessReviewInstanceDecisionItem wie die allgemein verfügbare Zugriffsüberprüfungs-API. Der Katalogbereich wird über den principalResourceMembershipsScope der Überprüfungsdefinition ausgedrückt.

Diese Ressource wird über die einheitliche Beziehung für die accessReviewSet-Ressource erreicht.

In der folgenden Tabelle wird zusammengefasst, wie sich die einheitliche Route von der aktuellen Zugriffsüberprüfungs-API unterscheidet.

Erbt von entity.

Methoden

Nur das Auflisten und Erstellen von Definitionen wird als dedizierte vereinheitlichte Methoden dokumentiert, da das Erstellen einer Überprüfung des Katalogbereichs der einzige Vorgang ist, der für die vereinheitlichte Route spezifisch ist. Nachdem eine Definition erstellt wurde, werden ihre Instanzen, Phasen und Entscheidungen über die freigegebenen Vorgänge accessReviewScheduleDefinition, accessReviewInstance und accessReviewInstanceDecisionItem (z. B. get, update, delete, list instances, stop und apply decisions) verwaltet, die unter dem identityGovernance/accessReviews/unified Pfadsegment adressiert sind. Der Abschnitt "Beispiele " zeigt diese gemeinsamen Vorgänge für den einheitlichen Pfad und verlinkt auf die entsprechenden Methodenseiten.

Eigenschaften

Keine.

Beziehungen

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.unifiedRoot"
}

Beispiele

Das Erstellen und Auflisten von benutzerzentrierten Definitionen (Katalogbereich) ist auf den Methodenseiten Definitionen auflisten und Definition erstellen dokumentiert. In den folgenden Beispielen wird gezeigt, wie Sie durch die Instanzen und Entscheidungen einer Definition navigieren und die Ergebnisse über die unified Route anwenden. Jede Anforderung wird unter dem identityGovernance/accessReviews/unified Pfadsegment behandelt.

Beispiel 1: Auflisten von Instanzen einer einheitlichen Definition für die Zugriffsüberprüfung

Im folgenden Beispiel sind die accessReviewInstance-Objekte für eine benutzerzentrierte Definition aufgeführt. Codebeispiele in den Microsoft Graph SDKs finden Sie unter Auflisten von Instanzen.

Anforderung

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances",
    "value": [
        {
            "id": "e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f",
            "status": "InProgress",
            "startDateTime": "2026-08-31T00:00:00Z",
            "endDateTime": "2026-09-06T00:00:00Z"
        }
    ]
}

Beispiel 2: Auflisten der zu überprüfenden Prinzipale für eine Instance

Im folgenden Beispiel werden die accessReviewInstanceDecisionItem-Objekte nach Prinzipal gruppiert, um die unterschiedlichen Benutzer zurückzugeben, deren Zugriff in der Instance überprüft wird. Codebeispiele in den Microsoft Graph SDKs finden Sie unter Entscheidungen auflisten.

Anforderung

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/decisions?$apply=groupby((principal/id,principal/displayName))

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances('e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f')/decisions",
    "value": [
        {
            "principal": {
                "id": "a4c6f1e2-6f2d-4b8a-9c3e-2f1a0b5d7e9c",
                "displayName": "Alex Wilber"
            }
        }
    ]
}

Beispiel 3: Auflisten von Entscheidungen für eine Instance

Im folgenden Beispiel sind die einzelnen accessReviewInstanceDecisionItem-Objekte – eines pro Prinzipal und Ressource – für eine benutzerzentrierte Überprüfungs-instance aufgeführt. Codebeispiele in den Microsoft Graph SDKs finden Sie unter Entscheidungen auflisten.

Anforderung

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/decisions

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances('e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f')/decisions",
    "value": [
        {
            "id": "9f8c2b1a-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
            "decision": "NotReviewed",
            "principal": {
                "id": "a4c6f1e2-6f2d-4b8a-9c3e-2f1a0b5d7e9c",
                "displayName": "Alex Wilber"
            },
            "resource": {
                "id": "b74444cb-038a-4802-8fc9-b9d1ed0cf11f",
                "displayName": "Marketing"
            }
        }
    ]
}

Beispiel 4: Beenden einer einheitlichen Zugriffsüberprüfungs-instance

Im folgenden Beispiel wird eine laufende benutzerzentrierte Überprüfungs-instance beendet. Codebeispiele in den Microsoft Graph SDKs finden Sie unter accessReviewInstance: stop.

Anforderung

POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/stop

Antwort

HTTP/1.1 204 No Content

Beispiel 5: Anwenden der Entscheidungen einer einheitlichen Zugriffsüberprüfungs-instance

Im folgenden Beispiel werden die aufgezeichneten Entscheidungen einer abgeschlossenen benutzerzentrierten Überprüfungs-instance angewendet. Codebeispiele in den Microsoft Graph SDKs finden Sie unter accessReviewInstance: applyDecisions.

Anforderung

POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/applyDecisions

Antwort

HTTP/1.1 204 No Content

Beispiel 6: Löschen einer einheitlichen Definition für die Zugriffsüberprüfung

Im folgenden Beispiel wird ein benutzerzentrierter accessReviewScheduleDefinition gelöscht. Codebeispiele in den Microsoft Graph SDKs finden Sie unter accessReviewScheduleDefinition löschen.

Anforderung

DELETE https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448

Antwort

HTTP/1.1 204 No Content