accessReviewScheduleDefinition リソースの種類

名前空間: microsoft.graph

重要

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

注意

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

Azure AD アクセス レビューのスケジュールを表します。

accessReviewScheduleDefinition には、 accessReviewInstance オブジェクトの一覧が含まれています。 スケジュール定義の繰り返しごとにインスタンスが作成されます。 インスタンスは、確認される各一意のリソースも表します。 スケジュール定義で複数のリソース (複数のグループを含む) を確認する場合、各リソースには、繰り返しごとに一意のインスタンスがあります。 1 回限りのレビューの場合、リソースごとに作成されるインスタンスは 1 つだけです。

メソッド

メソッド	戻り値の型	説明
accessReviewScheduleDefinitions を一覧表示する	accessReviewScheduleDefinition コレクション	すべての accessReviewScheduleDefinition を一覧表示します。 結果に関連する accessReviewInstance オブジェクトは含まれません。
accessReviewScheduleDefinition を取得する	accessReviewScheduleDefinition	指定した ID を持つ accessReviewScheduleDefinition を取得 します。結果に関連する accessReviewInstance オブジェクトは含まれません。
accessReviewScheduleDefinition を作成する	accessReviewScheduleDefinition	新しい accessReviewScheduleDefinition を作成します。
accessReviewScheduleDefinition を削除する	なし。	指定した ID を持つ accessReviewScheduleDefinition を削除します。
accessReviewScheduleDefinition を更新する	なし。	指定した ID で accessReviewScheduleDefinition のプロパティを更新 します。
filterByCurrentUser	accessReviewScheduleDefinition コレクション	呼び出し元のユーザーが 1 つ以上のインスタンスのレビュー担当者であるすべての定義を取得します。

プロパティ

プロパティ	型	説明
additionalNotificationRecipients	accessReviewNotificationRecipientItem コレクション	アクセス レビューの進行状況を通知する追加のユーザーまたはグループ メンバーの一覧を定義します。
createdBy	Useridentity	このレビューを作成したユーザー。 読み取り専用です。
createdDateTime	DateTimeOffset	アクセス レビュー シリーズが作成されたタイムスタンプ。 $select をサポートしています。 読み取り専用です。
descriptionForAdmins	String	管理者にレビューのより多くのコンテキストを提供するために、レビュー作成者によって提供される説明。 $select をサポートします。
descriptionForReviewers	String	レビュー作成者がレビューのより多くのコンテキストをレビュー担当者に提供する説明。 レビュー担当者は、レビューを要求する電子メールにこの説明が表示されます。 電子メール通知では、最大 256 文字がサポートされます。 $select をサポートしています。
displayName	文字列	アクセス レビュー シリーズの名前。 $select と $orderBy をサポートします。 作成時に必要です。
fallbackReviewers	accessReviewReviewerScope コレクション	このレビュー担当者スコープのコレクションは、フォールバック レビュー担当者の一覧を定義するために使用されます。 これらのフォールバック レビュー担当者には、指定されたレビュー担当者の一覧からユーザーが見つからない場合に、アクションを実行するように通知されます。 これは、グループ所有者が校閲者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。 accessReviewReviewerScope を参照してください。 backupReviewers を 置き換えます。 $select をサポートします。 メモ： フォールバック レビュー担当者が stageSettings プロパティを使用して割り当てられている場合、このプロパティの値は無視されます。
id	String	アクセス レビューの機能割り当て一意識別子。 $select をサポートしています。 読み取り専用です。
instanceEnumerationScope	accessReviewScope	このプロパティは、すべての Microsoft 365 グループにわたるゲスト ユーザーのアクセスに対するレビューのスコープを設定し、どの Microsoft 365 グループがレビューされるかを決定する場合に必要です。 各グループは、アクセス レビュー シリーズの一意の accessReviewInstance になります。 サポートされているスコープについては、「 accessReviewScope」を参照してください。 $select をサポートします。 instanceEnumerationScope を構成するためのオプションの例については、「Microsoft Graph APIを使用してアクセス レビュー定義のスコープを構成する」を参照してください。
instances	accessReviewInstance コレクション	このアクセス レビュー シリーズの一連のアクセス レビュー インスタンス。 繰り返されないアクセス レビューには、1 つのインスタンスのみが含まれます。それ以外の場合は、繰り返しごとにインスタンスが存在します。
lastModifiedDateTime	DateTimeOffset	アクセス レビュー シリーズが最後に変更されたタイムスタンプ。 $select をサポートしています。 読み取り専用です。
レビュー	accessReviewReviewerScope コレクション	このアクセス レビュー スコープのコレクションは、レビュー担当者を定義するために使用されます。 レビュー担当者プロパティは、個々のユーザーがレビュー担当者として割り当てられている場合にのみ更新できます。 作成時に必要です。 $select をサポートします。 レビュー担当者を割り当てるオプションの例については、「Microsoft Graph APIを使用してレビュー担当者をアクセス レビュー定義に割り当てる」を参照してください。 メモ： レビュー担当者が stageSettings プロパティを使用して割り当てられている場合、このプロパティの値は無視されます。
スコープ	accessReviewScope	アクセスがレビューされるエンティティを定義します。 サポートされているスコープについては、「 accessReviewScope」を参照してください。 作成時に必要です。 サポート $select と $filter (contains のみ)。 スコープを構成するためのオプションの例については、「Microsoft Graph APIを使用してアクセス レビュー定義のスコープを構成する」を参照してください。
stageSettings	accessReviewStageSettings コレクション	ステージとその設定を定義するには、複数ステージのアクセス レビューでのみ必要です。 各レビュー インスタンスを最大 3 つの連続したステージに分割できます。各ステージには、異なるレビュー担当者、フォールバック レビュー担当者、および設定のセットを含めることができます。 ステージは dependsOn プロパティに基づいて順番に作成されます。 省略可能。 このプロパティが定義されている場合、accessReviewScheduleDefinition オブジェクトとその設定、レビュー担当者、およびフォールバックReviewers プロパティの対応する設定の代わりに、その 設定 が使用されます。
settings	accessReviewScheduleSettings	アクセス レビュー シリーズの設定については、以下の種類の定義を参照してください。 $select をサポートします。 作成時に必要です。
status	String	この読み取り専用フィールドは、アクセス レビューの状態を指定します。 一般的な状態にはInitializing、, , , NotStarted, Starting``InProgress, Completing``Completed, AutoReviewing, および AutoReviewed. 、および $filter ( のみ)eq をサポートします$select。 $orderby 読み取り専用です。
backupReviewers (非推奨)	accessReviewReviewerScope コレクション	このレビュー担当者スコープのコレクションは、フォールバック レビュー担当者の一覧を定義するために使用されます。 これらのフォールバック レビュー担当者には、指定されたレビュー担当者の一覧からユーザーが見つからない場合に、アクションを実行するように通知されます。 これは、グループ所有者が校閲者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。 $select をサポートします。 メモ： このプロパティは、 フォールバックReviewers に置き換えられました。 ただし、 backupReviewers または フォールバックReviewers を指定すると、同じ値が他のプロパティに自動的に設定されます。

リレーションシップ

リレーションシップ	型	説明
instances	accessReviewInstance コレクション	accessReviewScheduleDefinition定期的なアクセス レビューの場合、インスタンスは各繰り返しを表します。 繰り返されないレビューには、インスタンスが 1 つだけ含まれます。 インスタンスは、. で確認中の各一意のリソースも表します accessReviewScheduleDefinition。 レビューに複数のリソースと複数のインスタンスがある場合、各リソースには繰り返しごとに一意のインスタンスが含まれます。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.accessReviewScheduleDefinition",
  "id": "String (identifier)",
  "displayName": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "status": "String",
  "descriptionForAdmins": "String",
  "descriptionForReviewers": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "reviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "fallbackReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "backupReviewers": [
    {
      "@odata.type": "microsoft.graph.accessReviewReviewerScope"
    }
  ],
  "instanceEnumerationScope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  },
  "stageSettings": [
    {
      "@odata.type": "microsoft.graph.accessReviewStageSettings"
    }
  ],
  "settings": {
    "@odata.type": "microsoft.graph.accessReviewScheduleSettings"
  },
  "additionalNotificationRecipients": [
    {
        "@odata.type": "microsoft.graph.accessReviewNotificationRecipientItem"
    }
  ]
}