accessReviewInstance リソースの種類

名前空間: microsoft.graph

Azure AD アクセス レビュー の繰り返しを表します。 親 accessReviewScheduleDefinition オブジェクトのシステム生成ベース。 すべてのプロパティは読み取り専用です。

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

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

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

メソッド

メソッド	戻り値の種類	説明
accessReviewInstances を一覧表示する	accessReviewInstance コレクション	accessReviewInstance オブジェクトとそのプロパティの一覧を取得します。
accessReviewInstance を取得する	accessReviewInstance	accessReviewInstance オブジェクトのプロパティとリレーションシップを読み取ります。
accessReviewInstance を更新する	accessReviewInstance	accessReviewInstance オブジェクトのレビュー担当者を更新します。
filterByCurrentUser	accessReviewInstance コレクション	呼び出し元のユーザーがレビュー担当者である定義上のすべてのインスタンス オブジェクトを返します。
連絡先の校閲者を一覧表示する	accessReviewReviewer コレクション	アクセス レビュー インスタンスの通知を受け取ったレビュー担当者を取得します。
sendReminder	なし	accessReviewInstance の校閲者にリマインダーを送信します。
stop	なし	accessReviewInstance を手動で停止します。
acceptRecommendations	なし	呼び出し元のユーザーが、特定の accessReviewInstance のレビュー担当者である NotReviewed accessReviewInstanceDecisionItem ごとに決定の推奨事項を受け入れることを許可します。
applyDecisions	なし	accessReviewInstance に対して手動で決定を適用します。
batchRecordDecisions	なし	1 回の呼び出しでプリンシパルまたはリソースのバッチを確認します。
resetDecisions	なし	インスタンス上のすべてのデシジョン 項目を notReviewed
決定を一覧表示する	accessReviewInstanceDecisionItem コレクション	decisions ナビゲーション プロパティから 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 をサポートしています。 読み取り専用です。
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を使用してレビュー担当者をアクセス レビュー定義に割り当てる」を参照してください。

リレーションシップ

リレーションシップ	型	説明
決定	accessReviewInstanceDecisionItem コレクション	accessReviewInstance でレビューされた各プリンシパルには、承認、拒否、またはまだ確認されていないかどうかを表す意思決定項目があります。
contactedReviewers	accessReviewReviewer コレクション	このレビューを完了するために連絡を受けた校閲者のコレクションを返します。 accessReviewScheduleDefinition の 校閲者 および フォールバックReviewers プロパティは、グループの所有者またはマネージャーを 校閲者 として指定する場合がありますが、contactedReviewers は個々の ID を返します。 $select をサポートしています。 読み取り専用です。

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"
    }
  ]
}