accessReviewInstance リソースの種類

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

名前空間: microsoft.graph

重要

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

注:

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

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	なし。	呼び出し元ユーザーが、特定の accessReviewInstance のレビュー担当者である NotReviewInstanceDecisionItem ごとに決定の推奨事項を受け入れることを許可します。
applyDecisions	なし。	accessReviewInstance に関する決定を手動で適用します。
stopApplyDecisions	なし。	呼び出し元のユーザーが特定の accessReviewInstance に対する適用決定アクションを停止できるようにします。
batchRecordDecisions	なし	1 回の呼び出しでプリンシパルまたはリソースのバッチを確認します。
resetDecisions	なし	インスタンス上のすべてのデシジョン項目をに `notReviewed`リセットします。
ステージを一覧表示する	accessReviewStage コレクション	マルチステージアクセスレビューインスタンスのステージを取得します。
決定を一覧表示する	accessReviewInstanceDecisionItem コレクション	意思決定ナビゲーションプロパティから accessReviewInstanceDecisionItem リソースを取得します。
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 レベルでスコープとインスタンス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` 読み取り専用です。
レビュー	accessReviewReviewerScope コレクション	このアクセスレビュースコープのコレクションは、レビュー担当者の定義に使用されます。 `$select` をサポートします。レビュー担当者を割り当てるオプションの例については、「Microsoft Graph APIを使用してレビュー担当者をアクセスレビュー定義に割り当てる」を参照してください。

リレーションシップ

リレーションシップ	型	説明
contactedReviewers	accessReviewReviewer コレクション	このレビューを完了するために連絡を取ったレビュー担当者のコレクションを返します。 accessReviewScheduleDefinition のレビュー担当者とフォールバックReviewers プロパティでは、グループ所有者またはマネージャーをレビュー担当者として指定する場合があります。contactedReviewers は個々の ID を返します。 `$select` をサポートしています。読み取り専用です。
definition	accessReviewScheduleDefinition	各インスタンスに関連付けられている accessReviewScheduleDefinition は 1 つだけです。これはインスタンスの親スケジュールです。ここで、レビュー定義の繰り返しごとにインスタンスが作成され、定義によってレビューするために選択された各グループが作成されます。
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"
    }
  ]
}