accessReview リソースの種類 (非推奨)
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注意
このバージョンのアクセス レビュー API は非推奨となり、2023 年 5 月 19 日にデータの返しを停止します。 アクセス レビュー API を使用してください。
Microsoft Entra アクセス レビューを表します。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| アクセス レビューを一覧表示する | accessReview コレクション | businessFlowTemplate の accessReviews を一覧表示します。 |
| アクセス レビューを取得する | accessReview | 特定の ID を持つアクセス レビューを取得します。 |
| アクセス レビューを作成する | accessReview | 新しい accessReview を作成します。 |
| アクセス レビューを更新する | accessReview | accessReview を更新します。 |
| アクセス レビューを削除する | なし。 | accessReview を削除します。 |
| Reviewer (校閲者) を一覧表示する | userIdentity コレクション | accessReview のレビュー担当者を取得します。 |
| Reviewer (校閲者) を追加する | なし。 | accessReview にレビュー担当者を追加します。 |
| Reviewer (校閲者) を削除する | なし。 | accessReview からレビュー担当者を削除します。 |
| 決定を一覧表示する | accessReviewDecision コレクション | accessReview の決定を取得します。 |
| 自分の決定を一覧表示する | accessReviewDecision コレクション | レビュー担当者として、accessReview の決定を取得します。 |
| リマインダーを送信する | なし。 | accessReview のレビュー担当者にリマインダーを送信します。 |
| Stop | なし。 | accessReview を停止します。 |
| Reset | なし。 | 進行中の accessReview で決定をリセットします。 |
| 意思決定を適用する | なし。 | 完了した accessReview からの決定を適用します。 |
プロパティ
| プロパティ | 種類 | 説明 |
|---|---|---|
| id | String | アクセス レビューの機能割り当て一意識別子。 |
| displayName | String | アクセス レビュー名。 作成時に必要です。 |
| startDateTime | DateTimeOffset | レビューが開始される予定の日時。 この日付は将来になる可能性があります。 作成時に必要です。 |
| endDateTime | DateTimeOffset | レビューが終了するようにスケジュールされている DateTime。 これは、開始日より少なくとも 1 日遅くする必要があります。 作成時に必要です。 |
| status | String | この読み取り専用フィールドは、accessReview の状態を指定します。 一般的な状態には、 Initializing、 NotStarted、 Starting、InProgress、 Completing、 Completed、 AutoReviewing、 AutoReviewedが含まれます。 |
| 説明 | String | レビュー担当者に表示する、アクセス レビュー作成者によって提供される説明。 |
| businessFlowTemplateId | String | ビジネス フロー テンプレート識別子。 作成時に必要です。 この値では大文字と小文字が区別されます。 |
| reviewerType | String | 対象オブジェクトに対するレビュー担当者のリレーションシップの種類( self、 delegated、 entityOwnersのいずれか)。 作成時に必要です。 |
| createdBy | userIdentity | このレビューを作成したユーザー。 |
| reviewedEntity | identity | アクセス レビューがアクセス権の割り当てを確認しているオブジェクト。 この ID は、グループ内のユーザーのメンバーシップのレビュー用のグループ、またはアプリケーションへのユーザーの割り当てのレビュー用のアプリです。 作成時に必要です。 |
| settings | accessReviewSettings | accessReview の設定については、以下の型定義を参照してください。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| レビュー | userIdentity コレクション | アクセス レビューのレビュー担当者のコレクション (アクセス レビューの reviewerType が delegated 型の場合)。 |
| 決定 | accessReviewDecision コレクション | このアクセス レビューに関する決定のコレクション。 |
| myDecisions | accessReviewDecision コレクション | 呼び出し元がレビュー担当者の場合は、呼び出し元の決定のコレクション。 |
| instances | accessReview コレクション | このオブジェクトが定期的なアクセス レビューである場合、アクセス レビューのコレクションは、過去、現在、および将来のインスタンスを確認します。 |
これらのリレーションシップがオブジェクトに存在するかどうかは、オブジェクトが 1 回限りのアクセス レビューか、一連の定期的なアクセス レビューか、定期的なアクセス レビューのインスタンスかによって異なります。
| シナリオ | レビュー担当者はいますか? | 決定と myDecisions はありますか? | インスタンスはありますか? |
|---|---|---|---|
| 1 回限りのアクセス レビュー | はい | はい(開始後) | いいえ |
| 定期的なアクセス レビュー | はい | いいえ | はい |
| 定期的なアクセス レビューのインスタンス | はい | はい(開始後) | いいえ |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"id": "string (identifier)",
"displayName": "string",
"startDateTime": "string (timestamp)",
"endDateTime": "string (timestamp)",
"status": "string",
"description": "string",
"businessFlowTemplateId": "string (identifier)",
"reviewerType": "string",
"createdBy": {"@odata.type": "microsoft.graph.userIdentity"},
"reviewedEntity": {"@odata.type": "microsoft.graph.identity"},
"settings": {"@odata.type": "microsoft.graph.accessReviewSettings"},
"reviewers": [{"@odata.type": "microsoft.graph.userIdentity"}]
}