accessReviewInstance リソースの種類

名前空間: microsoft.graph

重要

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

注意

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

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

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

メソッド

メソッド	戻り値の型	説明
accessReviewInstances を一覧表示する	accessReviewInstance コレクション	accessReviewInstance オブジェクトとそのプロパティの一覧を取得します。
accessReviewInstance を取得する	accessReviewInstance	accessReviewInstance オブジェクトのプロパティとリレーションシップを読み取ります。
accessReviewInstance を更新する	accessReviewInstance	accessReviewInstance オブジェクトのレビュー担当者を更新します。
filterByCurrentUser	accessReviewInstance コレクション	呼び出し元のユーザーが 1 つ以上の決定の校閲者である特定の accessReviewScheduleDefinition のすべてのインスタンスを返します。
連絡先の校閲者を一覧表示する	accessReviewReviewer コレクション	アクセス レビュー インスタンスの通知を受け取ったレビュー担当者を取得します。
sendReminder	なし。	accessReviewInstance の校閲者にリマインダーを送信します。
stop	なし。	accessReviewInstance を手動で停止します。
acceptRecommendations	なし。	呼び出し元のユーザーが、特定の accessReviewInstance のレビュー担当者である NotReviewed accessReviewInstanceDecisionItem ごとに決定の推奨事項を受け入れることを許可します。
applyDecisions	なし。	accessReviewInstance に対して手動で決定を適用します。
batchRecordDecisions	なし	1 回の呼び出しでプリンシパルまたはリソースのバッチを確認します。
resetDecisions	なし	インスタンス notReviewed上のすべてのデシジョン アイテムを .
ステージを一覧表示する	accessReviewStage コレクション	複数ステージのアクセス レビュー インスタンスでステージを取得します。
決定を一覧表示する	accessReviewInstanceDecisionItem コレクション	decisions ナビゲーション プロパティから accessReviewInstanceDecisionItem リソースを取得します。
List pendingAccessReviewInstances (非推奨)	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 レベルの スコープ と instanceEnumerationScope に基づいて作成されます。 グループ内でレビューされたユーザーのスコープを定義します。 サポート $select と $filter (contains のみ)。 読み取り専用です。
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, Completing``Completed, AutoReviewing, および AutoReviewed. 、および $filter ( のみ)eq をサポートします$select。 $orderby 読み取り専用です。
レビュー	accessReviewReviewerScope コレクション	このアクセス レビュー スコープのコレクションは、レビュー担当者を定義するために使用されます。 $select をサポートします。 レビュー担当者を割り当てるオプションの例については、「Microsoft Graph APIを使用してレビュー担当者をアクセス レビュー定義に割り当てる」を参照してください。

リレーションシップ

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

JSON 表記

以下は、リソースの JSON 表記です。

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "id": "string (identifier)",
 "displayName": "string",
 "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"
    }
  ]
}