次の方法で共有

accessReviews の一覧表示 (非推奨)

  • [アーティクル]

名前空間: microsoft.graph

重要

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

注意

このバージョンのアクセス レビュー API は非推奨となり、2023 年 5 月 19 日にデータの返しを停止します。 アクセス レビュー API を使用してください。

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

注:

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

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

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

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

この 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 ベアラー {token}。 必須です。

要求本文

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

応答

成功した場合、このメソッドは 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
応答

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

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

関連コンテンツ