accessReviewScheduleDefinition リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

重要

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

注:

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

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

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

メソッド

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

プロパティ

プロパティ 型 説明
additionalNotificationRecipients accessReviewNotificationRecipientItem コレクション アクセス レビューの進行状況を通知する追加のユーザーまたはグループ メンバーの一覧を定義します。
createdBy Useridentity このレビューを作成したユーザー。 読み取り専用です。
createdDateTime DateTimeOffset アクセス レビュー シリーズが作成されたときのタイムスタンプ。 $select をサポートしています。 読み取り専用です。
descriptionForAdmins String レビュー作成者が提供する説明。管理者にレビューのコンテキストを追加します。 $select をサポートします。
descriptionForReviewers 文字列 レビュー作成者によって提供される説明。レビュー担当者にレビューのより多くのコンテキストを提供します。 レビュー担当者は、レビューを要求するメールにこの説明を表示します。 Email通知では、最大 256 文字がサポートされます。 $select をサポートしています。
displayName 文字列 アクセス レビュー シリーズの名前。 $select と $orderby をサポートします。 作成時に必要です。
fallbackReviewers accessReviewReviewerScope コレクション このレビュー担当者スコープのコレクションは、フォールバック レビュー担当者の一覧を定義するために使用されます。 指定されたレビュー担当者の一覧からユーザーが見つからない場合は、これらのフォールバック レビュー担当者にアクションを実行するように通知されます。 これは、グループ所有者がレビュー担当者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。 accessReviewReviewerScope に関するページを参照してください。 backupReviewers を置き換えます。 $select をサポートします。

メモ： フォールバック レビュー担当者が stageSettings プロパティを使用して割り当てられている場合、このプロパティの値は無視されます。
id 文字列 アクセス レビューの機能割り当て一意識別子。 $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 プロパティを使用して割り当てられている場合、このプロパティの値は無視されます。
scope accessReviewScope アクセス権がレビューされるエンティティを定義します。 サポートされているスコープについては、「 accessReviewScope」を参照してください。 作成時に必要です。 と $filter (containsのみ) がサポートされます$select。 スコープを構成するためのオプションの例については、「Microsoft Graph APIを使用してアクセス レビュー定義のスコープを構成する」を参照してください。
stageSettings accessReviewStageSettings コレクション 複数ステージのアクセス レビューでステージとその設定を定義する場合にのみ必要です。 各レビュー インスタンスを最大 3 つのシーケンシャル ステージに分割できます。各ステージには、異なるレビュー担当者、フォールバック レビュー担当者、設定のセットを含めることができます。 ステージは dependsOn プロパティに基づいて順番に作成されます。 省略可能です。

このプロパティを定義すると、accessReviewScheduleDefinition オブジェクトとその設定、レビュー担当者、フォールバックReviewers プロパティの対応する設定の代わりに、その設定が使用されます。
settings accessReviewScheduleSettings アクセス レビュー シリーズの設定については、以下の「型の定義」を参照してください。 $select をサポートします。 作成時に必要です。
status String この読み取り専用フィールドは、アクセス レビューの状態を指定します。 一般的な状態には、、、、、、CompletedAutoReviewingCompletingInProgressおよび が含AutoReviewedまれます。InitializingStartingNotStarted
、、および ( のみ) がサポートされます$select$orderby。eq$filter 読み取り専用です。
backupReviewers (非推奨) accessReviewReviewerScope コレクション このレビュー担当者スコープのコレクションは、フォールバック レビュー担当者の一覧を定義するために使用されます。 これらのフォールバック レビュー担当者は、指定されたレビュー担当者の一覧からユーザーが見つからない場合にアクションを実行するように通知されます。 これは、グループ所有者がレビュー担当者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。 $select をサポートします。
メモ： このプロパティは 、fallbackReviewers に置き換えられました。 ただし、 backupReviewers または fallbackReviewers を指定すると、同じ値が他のプロパティに自動的に設定されます。

リレーションシップ

リレーションシップ 型 説明
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"
    }
  ]
}