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 オブジェクトにリンクします。
多くのアクセス レビューがフィルターと一致する場合は、効率を向上させ、タイムアウトを回避するために、ページ サイズのクエリ パラメーター (例: 100) と要求のクエリ パラメーターの両方 $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"}
}
]
}
関連コンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示