Freigeben über


Listeninstanzen

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.

Rufen Sie die accessReviewInstance-Objekte für eine bestimmte accessReviewScheduleDefinition ab. Eine Liste von null oder mehr accessReviewInstance-Objekten wird zurückgegeben, einschließlich aller geschachtelten Eigenschaften. Zurückgegebene Objekte enthalten keine zugeordneten accessReviewInstanceDecisionItems. Um die Entscheidungen für die Instanz abzurufen, verwenden Sie List accessReviewInstanceDecisionItem.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) AccessReview.Read.All AccessReview.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung AccessReview.Read.All AccessReview.ReadWrite.All

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.

Lesezugriffsüberprüfungen einer Gruppe oder App Lesezugriffsüberprüfungen einer Microsoft Entra-Rolle
Der Ersteller der Definition des Zugriffsüberprüfungszeitplans
Globaler Leser
Sicherheitsleseberechtigter
Benutzeradministrator
Sicherheitsadministrator für Identitätsgovernanceadministrator
Sicherheitsleseberechtigter
Identity Governance-Administrator
Administrator für
privilegierte Rollen – Sicherheitsadministrator

Informationen zum Anzeigen nur der Instanzen, für die der angemeldete Benutzer dem Prüfer zugewiesen ist, finden Sie unter Auflisten ausstehender Zugriffsüberprüfungsinstanzen.

HTTP-Anforderung

GET /identityGovernance/accessReviews/definitions/{definition-id}/instances

Optionale Abfrageparameter

Diese Methode unterstützt $selectdie OData-Abfrageparameter , $filter$orderby, $skip, und $top , um die Antwort anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Die Standardseitengröße für diese API beträgt 100 accessReviewInstance-Objekte . Um die Effizienz zu verbessern und Timeouts aufgrund großer Resultsets zu vermeiden, wenden Sie die Paginierung mit den $skip Abfrageparametern und $top an. Weitere Informationen finden Sie unter Paging der Microsoft Graph-Daten in Ihrer App.

Anforderungsheader

Keine.

Anforderungstext

Geben Sie keinen Anforderungstext an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein Array von accessReviewInstance-Objekten im Antworttext zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Abrufen aller Zugriffsüberprüfungsinstanzen für eine Definition.

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/8564a649-4f67-4e09-88e7-55def6530e88/instances?$top=100&$skip=0

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/definitions('8564a649-4f67-4e09-88e7-55def6530e88')/instances",
    "@odata.count": 2,
    "value": [
        {
            "id": "7bc18cf4-3d70-4009-bc8e-a7c5adb30849",
            "startDateTime": "2021-03-09T23:10:28.83Z",
            "endDateTime": "2021-03-09T23:10:28.83Z",
            "status": "Applied",
            "scope": {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/v1.0/groups/f661fdd0-f0f7-42c0-8281-e89c6527ac63/members/microsoft.graph.user/?$count=true&$filter=(userType eq 'Guest')",
                "queryType": "MicrosoftGraph",
                "queryRoot": null
            }
        },
        {
            "id": "f1f35945-3f42-4941-9f7b-465e545f6f99",
            "startDateTime": "2021-03-09T23:10:28.83Z",
            "endDateTime": "2021-03-09T23:10:28.83Z",
            "status": "Applied",
            "scope": {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/v1.0/groups/f4ac55b3-3b3c-417e-85bd-183bbda3ccf2/members/microsoft.graph.user/?$count=true&$filter=(userType eq 'Guest')",
                "queryType": "MicrosoftGraph",
                "queryRoot": null
            }
        }
    ]
}