AccessReview abrufenGet accessReview

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Rufen Sie in der Feature Azure AD Access Reviews ein accessReview -Objekt ab.In the Azure AD access reviews feature, retrieve an accessReview object.

Verwenden Sie die Liste accessReview Reviewers -API, um die Bearbeiter der Zugriffsüberprüfung abzurufen.To retrieve the reviewers of the access review, use the list accessReview reviewers API. Verwenden Sie die Liste accessReview Decisions API oder die Liste My accessReview Decisions API, um die Entscheidungen der Zugriffsüberprüfung abzurufen.To retrieve the decisions of the access review, use the list accessReview decisions API, or the list my accessReview decisions API.

Wenn es sich um eine wiederkehrende Zugriffsüberprüfung handelt, instances verwenden Sie die Beziehung, um eine accessReview -Auflistung der letzten, aktuellen und zukünftigen Instanzen der Zugriffsüberprüfung abzurufen.If this is a recurring access review, then use the instances relationship to retrieve an accessReview collection of the past, current, and future instances of the access review.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) AccessReview. Read. all, AccessReview. ReadWrite. Membership, AccessReview. ReadWrite. allAccessReview.Read.All, AccessReview.ReadWrite.Membership, AccessReview.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication AccessReview. Read. all, AccessReview. ReadWrite. MembershipAccessReview.Read.All, AccessReview.ReadWrite.Membership

Damit diese API aufgerufen werden kann, muss sich der angemeldete Benutzer auch in einer Verzeichnis Rolle befinden, die es Ihnen ermöglicht, eine Zugriffsüberprüfung zu lesen, oder der Benutzer kann als Prüfer für die Zugriffsüberprüfung zugewiesen werden.In order to call this API, the signed in user must also be in a directory role that permits them to read an access review, or the user can be assigned as a reviewer on the access review. Weitere Informationen finden Sie unter Role and Permission Requirements for Access Reviews.For more details, see the role and permission requirements for access reviews.

HTTP-AnforderungHTTP request

GET /accessReviews/{reviewId}

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Es sollte kein Anforderungstext angegeben werden.No request body should be supplied.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200, OK werden der Antwortcode und ein accessReview -Objekt im Antworttext zurückgegeben.If successful, this method returns a 200, OK response code and an accessReview object in the response body.

BeispielExample

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

Hinweis: Das hier gezeigte Antwortobjekt wurde möglicherweise zur besseren Lesbarkeit gekürzt. Ein tatsächlicher Aufruf gibt alle Eigenschaften zurück.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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 auchSee also