AccessReviewScheduleDefinition を取得する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
id で accessReviewScheduleDefinition オブジェクトを取得します。 これにより、関連する accessReviewInstance を除く、スケジュールされたアクセス レビュー シリーズのすべてのプロパティが返されます。 各 accessReviewScheduleDefinition には、少なくとも 1 つのインスタンスがあります。 インスタンスは、定期的なレビューの 1 回 (2021 年 3 月など) に特定のリソース (特定のグループのメンバーなど) のレビューを表します。
アクセス レビュー シリーズのインスタンスを取得するには、 accessReviewInstance API の一覧 を使用します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | AccessReview.Read.All | AccessReview.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | AccessReview.Read.All | AccessReview.ReadWrite.All |
職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされている Microsoft Entra ロール またはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。
| グループまたはアプリの読み取りアクセス レビュー | Microsoft Entra ロールのアクセス レビューの読み取り |
|---|---|
| アクセス レビュー スケジュール定義の作成者 グローバル閲覧者 セキュリティ閲覧者 ユーザー管理者 ID ガバナンス管理者 セキュリティ管理者 |
セキュリティ閲覧者 ID ガバナンス管理者 特権ロール管理者 セキュリティ管理者 |
呼び出し元のユーザーは、レビュー担当者として割り当てられているかどうかのアクセス レビューを読み取ることもできます。
HTTP 要求
GET /identityGovernance/accessReviews/definitions/{review-id}
オプションのクエリ パラメーター
このメソッドは、応答のカスタマイズに役立つ OData クエリ パラメーター $select サポートします。 一般的な情報については、「OData クエリ パラメーター」を参照してください。
要求ヘッダー
なし。
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは応答コード 200 OK と、応答本文の accessReviewScheduleDefinition オブジェクトを返します。
例
要求
GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/2b83cc42-09db-46f6-8c6e-16fec466a82d
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "60860cdd-fb4d-4054-91ba-f7544443baa6",
"displayName": "Test world",
"status": "InProgress",
"scope": {
"query": "/groups/b7a059cb-038a-4802-8fc9-b944440cf11f/transitiveMembers",
"queryType": "MicrosoftGraph"
},
"instanceEnumerationScope": {
"query": "/groups/b7a059cb-038a-4802-8fc9-b9d14444f11f",
"queryType": "MicrosoftGraph"
},
"reviewers": [],
"settings": {
"mailNotificationsEnabled": true,
"reminderNotificationsEnabled": true,
"justificationRequiredOnApproval": true,
"defaultDecisionEnabled": false,
"defaultDecision": "None",
"instanceDurationInDays": 0,
"autoApplyDecisionsEnabled": false,
"recommendationsEnabled": true,
"recurrence": {
"pattern": {
"type": "weekly",
"interval": 1,
"month": 0,
"dayOfMonth": 0,
"daysOfWeek": [],
"firstDayOfWeek": "sunday",
"index": "first"
},
"range": {
"type": "numbered",
"numberOfOccurrences": 0,
"recurrenceTimeZone": null,
"startDate": "2020-09-15",
"endDate": "9999-12-31"
}
}
}
}