Feedback Bearbeiten

AccessReviews auflisten (veraltet)

  • Artikel
  • 5 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Hinweis

Die Zugriffsüberprüfungs-APIs sind veraltet und geben am 19. Mai 2023 keine Daten mehr zurück. Verwenden Sie Access-Rezensionen.

Dient zum Abrufen der accessReview-Objekte für ein bestimmtes businessFlowTemplate-Objekt. Eine Liste von null oder mehr accessReview-Objekten wird für jede einmalige und wiederkehrende Zugriffsüberprüfung zurückgegeben, die mit dieser Geschäftsflussvorlage erstellt wurde. Beachten Sie, dass bei Geschäftsflussvorlagen-IDs die Groß-/Kleinschreibung beachtet wird.

Hinweis

Wenn eine der Zugriffsüberprüfungen, die dem Filter entsprechen, eine wiederkehrende Zugriffsüberprüfung ist, wird ein accessReview-Objekt zurückgegeben, um jede wiederkehrende Serie als Ganzes darzustellen, zusätzlich zu jeder aktuellen, vergangenen und der nächsten anstehenden Instanz. Wenn z. B. eine monatliche wiederkehrende Zugriffsüberprüfung von Gastmitgliedern der Gruppe A, eine vierteljährliche überprüfung des wiederkehrenden Zugriffs von Gastmitgliedern der Gruppe B und eine einmalige Zugriffsüberprüfung von Gastmitgliedern der Gruppe C erfolgt, hat jede dieser Wiederholungen soeben begonnen, und der Aufrufer fragt Zugriffsüberprüfungen mit einer Geschäftsflussvorlage mit Rezensionen 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. Um die Instanzen einer wiederkehrenden Zugriffsüberprüfung oder die Für einen bestimmten Monat oder ein bestimmtes Quartal geplante Zugriffsüberprüfungsinstanz abzurufen, kann der Aufrufer anschließend in der Instanzbeziehung des wiederkehrenden accessReview-Objekts navigieren. Die Instanzbeziehungen sind mit den accessReview-Objekten für eine aktuelle oder die vergangenen Instanzen der wiederkehrenden Zugriffsüberprüfung verknüpft.

Wenn viele Zugriffsüberprüfungen dem Filter entsprechen, rufen Sie das Resultset in 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 die Anforderung mehrere Seiten umfasst. 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 Seite mit Ergebnissen 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 Einstellungen oder Beziehungen für die Zugriffsüberprüfung die AccessReview-API .

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) AccessReview.Read.All, AccessReview.ReadWrite.Membership, AccessReview.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung AccessReview.Read.All, AccessReview.ReadWrite.Membership

Der angemeldete Benutzer muss sich auch in einer Verzeichnisrolle befinden, die es dem Benutzer 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 einen 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 eine 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"}
       }
    ]
}

Siehe auch