accessReviewStage リソースの種類

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

名前空間: microsoft.graph

重要

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

注:

これは、アクセスレビューに推奨される API です。以前のバージョンのアクセスレビュー API は非推奨になりました。

Microsoft Entra アクセスレビューの繰り返しのステージを表します。親 accessReviewScheduleDefinition で stageSettings プロパティが定義されている場合、 accessReviewInstance は最大 3 つの後続のステージで構成されます。各ステージには、ステージの決定に基づいて行動できる異なるレビュー担当者のセットと、ステージ間で渡される決定を決定する設定を含めることができます。

すべての accessReviewStage には、レビュー担当者がアクションを実行できる決定の一覧が含まれています。確認される ID ごとに決定は 1 つだけです。

メソッド

メソッド	戻り値の種類	説明
accessReviewStages を一覧表示する	accessReviewStage コレクション	accessReviewStage オブジェクトとそのプロパティの一覧を取得します。
AccessReviewStage を取得する	accessReviewStage	accessReviewStage オブジェクトのプロパティとリレーションシップを読み取ります。
accessReviewStage を更新する	accessReviewStage	accessReviewStage オブジェクトのプロパティを更新します。
stop	なし	accessReviewStage を手動で停止します。
filterByCurrentUser	accessReviewStage コレクション	呼び出し元ユーザーがレビュー担当者である特定の accessReviewInstance のすべてのステージを返します。
決定を一覧表示する	accessReviewInstanceDecisionItem コレクション	accessReviewStage で行われた決定を取得します。

プロパティ

プロパティ	型	説明
endDateTime	DateTimeOffset	レビューステージが終了するようにスケジュールされている DateTime。 DatetimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。このプロパティは、すべてのステージの durationInDays の累積合計です。読み取り専用。
fallbackReviewers	accessReviewReviewerScope コレクション	このレビュー担当者スコープのコレクションは、フォールバックレビュー担当者の一覧を定義するために使用されます。これらのフォールバックレビュー担当者は、指定されたレビュー担当者の一覧からユーザーが見つからない場合にアクションを実行するように通知されます。これは、グループ所有者がレビュー担当者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。
id	String	ステージの一意識別子。読み取り専用。
レビュー	accessReviewReviewerScope コレクション	このアクセスレビュースコープのコレクションは、レビュー担当者の定義に使用されます。レビュー担当者を割り当てるオプションの例については、「Microsoft Graph APIを使用してレビュー担当者をアクセスレビュー定義に割り当てる」を参照してください。
startDateTime	DateTimeOffset	レビューステージが開始するようにスケジュールされている DateTime。将来の可能性があります。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、`2014-01-01T00:00:00Z` です。読み取り専用。
status	String	accessReviewStage の状態を指定します。指定できる値は、`Initializing`、`NotStarted`、、`Starting`、`InProgress`、`CompletedCompletingAutoReviewing`および `AutoReviewed`です。、と `$filter` (`eq` のみ) がサポートされます`$orderby`。読み取り専用です。

リレーションシップ

リレーションシップ	型	説明
決定	accessReviewInstanceDecisionItem コレクション	accessReviewStage でレビューされた各ユーザーには、承認、拒否、またはまだレビューされていないかどうかを表す決定項目があります。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.accessReviewStage",
  "id": "String (identifier)",
  "startDateTime": "String (timestamp)",
  "endDateTime": "String (timestamp)",
  "status": "String",
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ]
}