次の方法で共有


accessReviewInstance リソースの種類

名前空間: microsoft.graph

重要

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

注:

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

Microsoft Entra アクセス レビュー の繰り返しを表します。 親 accessReviewScheduleDefinition が定期的なアクセス レビューである場合、インスタンスは各繰り返しを表します。 繰り返されないレビューには、インスタンスが正確に 1 つ存在します。 インスタンスは、スケジュール定義でレビューされる各一意のグループも表します。 スケジュール定義で複数のグループがレビューされる場合、各グループには、繰り返しごとに一意のインスタンスがあります。

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

メソッド

メソッド 戻り値の型 説明
List accessReviewInstance コレクション accessReviewInstance オブジェクトとそのプロパティの一覧を取得します。
Get accessReviewInstance accessReviewInstance オブジェクトのプロパティとリレーションシップを読み取ります。
Update accessReviewInstance accessReviewInstance オブジェクトのレビュー担当者を更新します。
現在のユーザーでフィルター処理する accessReviewInstance コレクション 呼び出し元ユーザーが 1 つ以上の決定のレビュー担当者である特定の accessReviewScheduleDefinition のすべてのインスタンスを返します。
連絡を受けたレビュー担当者を一覧表示する accessReviewReviewer コレクション アクセス レビュー インスタンスの通知を受け取ったレビュー担当者を取得します。
リマインダーを送信する なし。 accessReviewInstance のレビュー担当者にリマインダーを送信します。
Stop なし。 accessReviewInstance を手動で停止します。
推奨事項を受け入れる なし。 呼び出し元ユーザーが、特定の accessReviewInstance のレビュー担当者である NotReviewInstanceDecisionItem ごとに決定の推奨事項を受け入れることを許可します。
意思決定を適用する なし。 accessReviewInstance に関する決定を手動で適用します。
適用の決定を停止する なし。 呼び出し元のユーザーが特定の accessReviewInstance に対する適用決定アクションを停止できるようにします。
バッチ レコードの決定 なし 1 回の呼び出しでプリンシパルまたはリソースのバッチを確認します。
意思決定をリセットする なし インスタンス上のすべてのデシジョン アイテムを notReviewedにリセットします。
ステージを一覧表示する accessReviewStage コレクション マルチステージ アクセス レビュー インスタンスのステージを取得します。
決定を一覧表示する accessReviewInstanceDecisionItem コレクション 意思決定ナビゲーション プロパティから accessReviewInstanceDecisionItem リソースを取得します。
保留中のアクセス レビュー インスタンスを一覧表示する (非推奨) accessReviewInstance コレクション。 保留中のすべての accessReviewInstance リソースを取得し、呼び出し元のユーザーに割り当てます。 このメソッドは非推奨になり、 filterByCurrentUser に置き換えられます。

プロパティ

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

リレーションシップ

リレーションシップ 説明
contactedReviewers accessReviewReviewer コレクション このレビューを完了するために連絡を取ったレビュー担当者のコレクションを返します。 accessReviewScheduleDefinitionレビュー担当者フォールバックReviewers プロパティでは、グループ所有者またはマネージャーをレビュー担当者として指定する場合があります。contactedReviewers は個々の ID を返します。 $select をサポートしています。 読み取り専用です。
definition accessReviewScheduleDefinition 各インスタンスに関連付けられている accessReviewScheduleDefinition は 1 つだけです。 これはインスタンスの親スケジュールです。ここで、レビュー定義の繰り返しごとにインスタンスが作成され、定義によってレビューするために選択された各グループが作成されます。
stages accessReviewStage コレクション インスタンスに複数のステージがある場合は、ステージのコレクションが返されます。 新しいステージは、前のステージが終了したときにのみ作成されます。 レビュー インスタンスのステージの存在、数、設定は、親 accessReviewScheduleDefinitionaccessReviewStageSettings に基づいて作成されます。
決定 accessReviewInstanceDecisionItem コレクション accessReviewInstance でレビューされた各ユーザーには、承認、拒否、またはまだレビューされていないかどうかを表す決定項目があります。

JSON 表記

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

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "id": "string (identifier)",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "contactedReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewer"
    }
  ]
}