accessReview リソースの種類 (非推奨)

[アーティクル]
04/09/2024

名前空間: microsoft.graph

重要

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

注意

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

Microsoft Entraアクセスレビューを表します。

メソッド

メソッド	戻り値の型	説明
accessReviews を一覧表示する	accessReview コレクション	businessFlowTemplate の accessReviews を一覧表示します。
AccessReview を取得する	accessReview	特定の ID を持つアクセスレビューを取得します。
accessReview の作成	accessReview	新しい accessReview を作成します。
accessReview の更新	accessReview	accessReview を更新します。
accessReview を削除する	なし。	accessReview を削除します。
accessReview レビュー担当者を一覧表示する	userIdentity コレクション	accessReview のレビュー担当者を取得します。
accessReview レビュー担当者を追加する	なし。	accessReview にレビュー担当者を追加します。
accessReview レビュー担当者を削除する	なし。	accessReview からレビュー担当者を削除します。
accessReview の決定を一覧表示する	accessReviewDecision コレクション	accessReview の決定を取得します。
accessReview の決定を一覧表示する	accessReviewDecision コレクション	レビュー担当者として、accessReview の決定を取得します。
AccessReview リマインダーを送信する	なし。	accessReview のレビュー担当者にリマインダーを送信します。
アクセスを停止するReview	なし。	accessReview を停止します。
accessReview の決定をリセットする	なし。	進行中の accessReview で決定をリセットします。
accessReview の決定を適用する	なし。	完了した accessReview からの決定を適用します。

プロパティ

プロパティ	型	説明
id	String	アクセスレビューの機能割り当て一意識別子。
displayName	String	アクセスレビュー名。作成時に必要です。
startDateTime	DateTimeOffset	レビューが開始される予定の日時。この日付は将来になる可能性があります。作成時に必要です。
endDateTime	DateTimeOffset	レビューが終了するようにスケジュールされている DateTime。これは、開始日より少なくとも 1 日遅くする必要があります。作成時に必要です。
status	String	この読み取り専用フィールドは、accessReview の状態を指定します。一般的な状態には、`StartingInProgress`、`CompletingAutoReviewingCompleted`およびが含`AutoReviewed`まれます。`InitializingNotStarted`
説明	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"}]
}