accessReviews の一覧表示 (非推奨)

[アーティクル]
06/01/2022

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

注意

アクセスレビュー API は廃止され、2023 年 5 月 19 日にデータの返しを停止します。 Access レビューを使用してください。

特定の businessFlowTemplate の accessReview オブジェクトを取得します。そのビジネスフローテンプレートで作成された 1 回限りの定期的なアクセスレビューごとに、0 個以上の accessReview オブジェクトの一覧が返されます。ビジネスフローテンプレート ID では大文字と小文字が区別されることに注意してください。

注意

フィルターに一致するアクセスレビューのいずれかが定期的なアクセスレビューである場合は、現在、過去、および次に予定されているインスタンスに加えて、1 つの accessReview オブジェクトが返され、各定期的なシリーズ全体が表されます。たとえば、グループ A のゲストメンバーの毎月の定期的なアクセスレビュー、グループ B のゲストメンバーの四半期ごとの定期的なアクセスレビュー、グループ C のゲストメンバーの 1 回限りのアクセスレビューがある場合、これらの繰り返しはそれぞれ開始され、グループのゲストメンバーのレビューのビジネスフローテンプレートを使用してアクセスレビューの呼び出し元のクエリが開始されました。 3 つのシリーズを表す 3 つのオブジェクトと、現在のアクセスレビューインスタンスの 3 つのオブジェクト、および次の今後のインスタンスに対して 3 つのオブジェクトが返される可能性があります。定期的なアクセスレビューのインスタンス、または特定の月または四半期にスケジュールされたアクセスレビューインスタンスを取得するには、呼び出し元は、その後、定期的な accessReview オブジェクトの インスタンス リレーションシップを移動できます。 インスタンス リレーションシップは、定期的なアクセスレビューの現在または過去のインスタンスの accessReview オブジェクトにリンクします。

多くのアクセスレビューがフィルターと一致する場合は、効率を向上させ、タイムアウトを回避するために、ページサイズが 100 のクエリパラメーターと$skip=0、要求にクエリパラメーターの両方$topを含めることで、ページ内の結果セットを取得します。これらのパラメーターは、要求が複数のページにまたがることが予想されない場合でも含めることができます。結果セットが複数のページにまたがる場合、Microsoft Graphは、結果の次のページ@odata.nextLinkへの URL を含む応答内のプロパティを含むページを返します。そのプロパティが存在する場合は、「アプリの Microsoft Graph のデータをアプリでページングするする」で説明されているように、各回答の @odata.nextLink URL を使用して、すべての結果が返されるまで追加の要求を続けます。

この API によって返される accessReview オブジェクトには、設定やリレーションシップなどの入れ子になった構造プロパティは含まれません。アクセスレビューの設定またはリレーションシップを取得するには、 accessReview API の取得を使用します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	AccessReview.Read.All、AccessReview.ReadWrite.Membership、AccessReview.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	AccessReview.Read.All、AccessReview.ReadWrite.Membership

サインインしているユーザーは、アクセスレビューの読み取りを許可するディレクトリロールにも含まれている必要があります。

HTTP 要求

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

要求ヘッダー

名前	型	説明
Authorization	string	ベアラー {トークン}。必須。

要求本文

要求本文を指定しないでください。

応答

成功した場合、このメソッドは 200 OK 応答コードと応答本文内の accessReview オブジェクトの配列を返します。

例

要求

次の例は、ビジネスフローテンプレート '6e4f3d20-c5c3-407f-9695-8460952bcc68' のすべての 1 回限りの定期的なアクセスレビューを取得する要求を示しています。

GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateId+eq+'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$top=100&$skip=0


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var accessReviews = await graphClient.AccessReviews
    .Request()
    .Filter("businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'")
    .Skip(0)
    .Top(100)
    .GetAsync();

重要

Microsoft Graph SDK では、既定で v1.0 バージョンの API が使用され、ベータ版で使用できるすべての種類、プロパティ、API はサポートされていません。 SDK を使用してベータ API にアクセスする方法の詳細については、「Microsoft Graph SDK とベータ API を使用する」を参照してください。

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


const options = {
    authProvider,
};

const client = Client.init(options);

let accessReviews = await client.api('/accessReviews')
    .version('beta')
    .filter('businessFlowTemplateId eq \'6e4f3d20-c5c3-407f-9695-8460952bcc68\'')
    .skip(0)
    .top(100)
    .get();

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/accessReviews?$filter=businessFlowTemplateId%20eq%20'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$top=100&$skip=0"]]];
[urlRequest setHTTPMethod:@"GET"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        NSError *jsonError = nil;
        MSCollection *collection = [[MSCollection alloc] initWithData:data error:&jsonError];
        MSGraphAccessReview *accessReview = [[MSGraphAccessReview alloc] initWithDictionary:[[collection value] objectAtIndex: 0] error:&nserror];

}];

[meDataTask execute];

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

AccessReviewCollectionPage accessReviews = graphClient.accessReviews()
    .buildRequest()
    .filter("businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'")
    .skip(0)
    .top(100)
    .get();

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestParameters := &msgraphsdk.AccessReviewsRequestBuilderGetQueryParameters{
    Filter: "businessFlowTemplateId%20eq%20'6e4f3d20-c5c3-407f-9695-8460952bcc68'",
    Top: 100,
    Skip: 0,
}
options := &msgraphsdk.AccessReviewsRequestBuilderGetRequestConfiguration{
    QueryParameters: requestParameters,
}
result, err := graphClient.AccessReviews().GetWithRequestConfigurationAndResponseHandler(options, nil)

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。


Import-Module Microsoft.Graph.Identity.Governance

Get-MgAccessReview -Filter "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'" -Top 100 -Skip 0

重要

SDK をプロジェクトに追加し、authProvider インスタンスを作成する方法の詳細については、SDK のドキュメントを参照してください。

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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"}
       }
    ]
}

accessReviews の一覧表示 (非推奨)

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

関連項目

フィードバック