AccessReview を取得するGet accessReview

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

Azure AD access レビュー機能で、 accessreviewオブジェクトを取得します。In the Azure AD access reviews feature, retrieve an accessReview object.

アクセスレビューのレビュー担当者を取得するには、 List accessreview レビューアー API を使用します。To retrieve the reviewers of the access review, use the list accessReview reviewers API. アクセスレビューの決定を取得するには、「リストアクセスレビュー決定api」、または「 My accessreview review 決定api の一覧」を使用します。To retrieve the decisions of the access review, use the list accessReview decisions API, or the list my accessReview decisions API.

これが定期的なアクセスレビューである場合は、 instancesリレーションシップを使用して、アクセスレビューの過去、現在、および今後のインスタンスのaccessreviewコレクションを取得します。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.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Accessreview を参照してください。この後、accessreview を参照してください。AccessReview.Read.All, AccessReview.ReadWrite.Membership, AccessReview.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication AccessReview を参照してください。AccessReview.Read.All, AccessReview.ReadWrite.Membership

この API を呼び出すためには、サインインしているユーザーが、アクセスレビューを読み取ることを許可するディレクトリロールにあるか、アクセスレビューのレビュー担当者としてユーザーを割り当てることも必要です。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. 詳細については、「アクセスレビューの役割とアクセス許可の要件」を参照してください。For more details, see the role and permission requirements for access reviews.

HTTP 要求HTTP request

GET /accessReviews/{reviewId}

要求ヘッダーRequest headers

名前Name Type 説明Description
AuthorizationAuthorization stringstring ベアラー {トークン}。必須。Bearer {token}. Required.

要求本文Request body

要求本文を指定する必要はありません。No request body should be supplied.

応答Response

成功した場合、このメソッド200, OKは応答コードと、応答本文でaccessreviewオブジェクトを返します。If successful, this method returns a 200, OK response code and an accessReview object in the response body.

Example

要求Request
GET https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16fec466a82d
応答Response

注: 読みやすくするために、ここに示す応答オブジェクトは短くされている場合があります。実際の呼び出しからは、すべてのプロパティが返されます。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"
        }
    }
}

関連項目See also