Feedback Bearbeiten

AccessReview abrufen (veraltet)

  • Artikel
  • 4 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.

Rufen Sie im Azure AD-Zugriffsüberprüfungsfeature ein accessReview-Objekt ab.

Um die Bearbeiter der Zugriffsüberprüfung abzurufen, verwenden Sie die Listen-AccessReview-Prüfer-API . Um die Entscheidungen der Zugriffsüberprüfung abzurufen, verwenden Sie die AccessReview-Entscheidungs-API für die Liste oder die Api für meine accessReview-Entscheidungen .

Wenn es sich um eine wiederkehrende Zugriffsüberprüfung handelt, werden keine Entscheidungen mit der Serie der wiederkehrenden Zugriffsprüfungen verknüpft. Verwenden Sie stattdessen die instances Beziehung dieser Datenreihe, um eine accessReview-Auflistung der vergangenen, aktuellen und zukünftigen Instanzen der Zugriffsüberprüfung abzurufen. Jede vergangene und aktuelle Instanz hat Entscheidungen.

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

Um diese API aufzurufen, muss sich der angemeldete Benutzer auch in einer Verzeichnisrolle befinden, die es ihm ermöglicht, eine Zugriffsüberprüfung zu lesen, oder der Benutzer kann als Prüfer für die Zugriffsüberprüfung zugewiesen werden. Weitere Informationen finden Sie in den Rollen- und Berechtigungsanforderungen für Zugriffsüberprüfungen.

HTTP-Anforderung

GET /accessReviews/{reviewId}

Anforderungsheader

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

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein accessReview-Objekt im Antworttext zurück.

Beispiel

Anforderung
GET https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16fec466a82d
Antwort

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

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

{
    "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"},
    "settings": {
        "mailNotificationsEnabled": true,
        "remindersEnabled": true,
        "justificationRequiredOnApproval": true,
        "autoReviewEnabled": false,
        "activityDurationInDays": 30,
        "autoApplyReviewResultsEnabled": false,
        "accessRecommendationsEnabled": false,
        "recurrenceSettings": {
            "recurrenceType": "onetime",
            "recurrenceEndType": "endBy",
            "durationInDays": 0,
            "recurrenceCount": 0
        },
        "autoReviewSettings": {
            "notReviewedResult": "Deny"
        }
    }
}

Siehe auch