accessReviewInstance リソースの種類

[アーティクル]
03/15/2023

名前空間: microsoft.graph

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

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

エンティティから継承します。

メソッド

メソッド	戻り値の型	説明
accessReviewInstances を一覧表示する	accessReviewInstance コレクション	accessReviewInstance オブジェクトとそのプロパティの一覧を取得します。
AccessReviewInstance を取得する	accessReviewInstance	accessReviewInstance オブジェクトのプロパティとリレーションシップを読み取ります。
accessReviewInstance を更新する	accessReviewInstance	accessReviewInstance オブジェクトのレビュー担当者を更新します。
filterByCurrentUser	accessReviewInstance コレクション	呼び出し元ユーザーが 1 つ以上の決定のレビュー担当者である特定の accessReviewScheduleDefinition のすべてのインスタンスを返します。
連絡先のレビュー担当者を一覧表示する	accessReviewReviewer コレクション	アクセスレビューインスタンスの通知を受け取ったレビュー担当者を取得します。
sendReminder	なし	accessReviewInstance のレビュー担当者にリマインダーを送信します。
stop	なし	accessReviewInstance を手動で停止します。
acceptRecommendations	なし	呼び出し元ユーザーがとしてマークされ`NotReviewed`、呼び出し元が関連する accessReviewInstance のレビュー担当者である accessReviewInstanceDecisionItem ごとに決定の推奨事項を受け入れることを許可します。
applyDecisions	なし	accessReviewInstance に関する決定を手動で適用します。
batchRecordDecisions	なし	1 回の呼び出しでプリンシパルまたはリソースのバッチを確認します。
resetDecisions	なし	インスタンス上のすべてのデシジョン項目をに `notReviewed`リセットします。
ステージを一覧表示する	accessReviewStage コレクション	マルチステージアクセスレビューインスタンスのステージを取得します。
決定を一覧表示する	accessReviewInstanceDecisionItem コレクション	意思決定ナビゲーションプロパティから accessReviewInstanceDecisionItem リソースを取得します。

プロパティ

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

リレーションシップ

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

JSON 表記

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

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