Freigeben über

AccessReviews auflisten (veraltet)

  • Artikel

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.

Rufen Sie die accessReview-Objekte für eine bestimmte businessFlowTemplate ab. Für jede einmalige und wiederkehrende Zugriffsüberprüfung, die mit dieser Geschäftsflowvorlage erstellt wurde, wird eine Liste von null oder mehr accessReview-Objekten zurückgegeben. Beachten Sie, dass bei Geschäftsflowvorlagen-IDs die Groß-/Kleinschreibung beachtet wird.

Hinweis

Wenn es sich bei einer der Zugriffsüberprüfungen, die mit dem Filter übereinstimmen, um eine wiederkehrende Zugriffsüberprüfung handelt, wird ein accessReview-Objekt zurückgegeben, das jede wiederkehrende Reihe als Ganzes darstellt, zusätzlich zu allen aktuellen, vergangenen und nächsten anstehenden instance. Wenn es beispielsweise eine monatliche wiederkehrende Zugriffsüberprüfung von Gastmitgliedern der Gruppe A, eine vierteljährliche wiederkehrende Zugriffsüberprüfung von Gastmitgliedern der Gruppe B und eine einmalige Zugriffsüberprüfung für Gastmitglieder von Gruppe C gibt, wurde jede dieser Wiederholungen gerade gestartet, und der Aufrufer fragt Zugriffsüberprüfungen mit einer Geschäftsflussvorlage mit Überprüfungen von Gastmitgliedern von Gruppen ab, Es werden drei Objekte zurückgegeben, die die drei Datenreihen darstellen, sowie drei Objekte für die aktuellen Zugriffsüberprüfungsinstanzen und potenziell drei Objekte für die nächsten anstehenden Instanzen. Zum Abrufen der Instanzen einer wiederkehrenden Zugriffsüberprüfung oder der für einen bestimmten Monat oder Quartal geplanten Zugriffsüberprüfung instance kann der Aufrufer anschließend in der instance Beziehung des wiederkehrenden accessReview-Objekts navigieren. Die instance Beziehung ist mit den accessReview-Objekten für eine aktuelle oder frühere Instanz der wiederkehrenden Zugriffsüberprüfung verknüpft.

Wenn viele Zugriffsüberprüfungen mit dem Filter übereinstimmen, rufen Sie das Resultset auf Seiten ab, um die Effizienz zu verbessern und Timeouts zu vermeiden, indem Sie sowohl den $top Abfrageparameter mit einer Seitengröße (z. B. 100) als auch den $skip=0 Abfrageparameter in die Anforderung einschließen. Diese Parameter können auch dann einbezogen werden, wenn Sie nicht davon ausgehen, dass sich die Anforderung über mehrere Seiten erstreckt. Wenn ein Resultset mehrere Seiten umfasst, gibt Microsoft Graph diese Seite mit einer @odata.nextLink Eigenschaft in der Antwort zurück, die eine URL zur nächsten Ergebnisseite enthält. Wenn diese Eigenschaft vorhanden ist, stellen Sie als Nächstes zusätzliche Anforderungen mit der URL @odata.nextLink in jeder Antwort, bis alle Ergebnisse zurückgegeben werden, wie in Paging der Microsoft Graph-Daten in Ihrer App beschrieben.

Die von dieser API zurückgegebenen accessReview-Objekte enthalten keine geschachtelten Struktureigenschaften wie Einstellungen oder Beziehungen. Verwenden Sie zum Abrufen von Zugriffsüberprüfungseinstellungen oder -beziehungen die Get accessReview-API .

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.Membership, AccessReview.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung AccessReview.Read.All AccessReview.ReadWrite.Membership

Der angemeldete Benutzer muss sich auch in einer Verzeichnisrolle befinden, die es ihnen ermöglicht, eine Zugriffsüberprüfung zu lesen.

HTTP-Anforderung

GET /accessReviews?$filter=businessFlowTemplateId eq {businessFlowTemplate-id}&$top={pagesize}&$skip=0

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie keinen Anforderungstext an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein Array von accessReview-Objekten im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Abrufen aller einmaligen und wiederkehrenden Zugriffsüberprüfungen für die Geschäftsflussvorlage "6e4f3d20-c5c3-407f-9695-8460952bcc68".

GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateId+eq+'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$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

{
    "value":[
       {
         "id": "2b83cc42-09db-46f6-8c6e-16fec466a82d",
         "displayName": "review",
         "startDateTime": "2017-11-14T01:14:54.89Z",
         "endDateTime": "2017-12-14T01:14:54.89Z",
         "status": "InProgress",
         "businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
         "reviewerType": "self",
         "description": "",
         "reviewedEntity":{"id":"3b4f7e74-eb82-4120-9ff5-ba429c1ea6df","displayName":"Salesforce"}
       }
    ]
}

Verwandte Inhalte