accessReviewScheduleDefinition リソースの種類
名前空間: microsoft.graph
Microsoft Entra アクセス レビューのスケジュールを表します。
エンティティ から継承します。 accessReviewScheduleDefinition には、 accessReviewInstance オブジェクトの一覧が含まれています。 スケジュール定義の繰り返しごとに、インスタンスが作成されます。 インスタンスは、レビューされる各一意のリソースも表します。 スケジュール定義で複数のリソース (複数のグループを含む) を確認する場合、各リソースには、繰り返しごとに一意のインスタンスがあります。 1 回限りのレビューの場合、リソースごとに作成されるインスタンスは 1 つだけです。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List | accessReviewScheduleDefinition コレクション | すべての accessReviewScheduleDefinition をListsします。 関連する accessReviewInstance オブジェクトは結果に含まれません。 |
| Get | accessReviewScheduleDefinition | 指定した ID を使用して accessReviewScheduleDefinition を取得 します。関連する accessReviewInstance オブジェクトは結果に含まれません。 |
| Create | accessReviewScheduleDefinition | 新しい accessReviewScheduleDefinition をCreateします。 |
| Delete | なし。 | 指定した ID を使用して accessReviewScheduleDefinition を削除します。 |
| Update | なし。 | accessReviewScheduleDefinition のプロパティを、指定した ID で更新します。 |
| 現在のユーザーでフィルター処理する | accessReviewScheduleDefinition コレクション | 呼び出し元のユーザーが 1 つ以上のインスタンスのレビュー担当者であるすべての定義を取得します。 |
プロパティ
| プロパティ | 種類 | 説明 |
|---|---|---|
| additionalNotificationRecipients | accessReviewNotificationRecipientItem コレクション | アクセス レビューの進行状況を通知する追加のユーザーまたはグループ メンバーの一覧を定義します。 |
| backupReviewers (非推奨) | accessReviewReviewerScope コレクション | このレビュー担当者スコープのコレクションは、フォールバック レビュー担当者の一覧を定義するために使用されます。 これらのフォールバック レビュー担当者は、指定されたレビュー担当者の一覧からユーザーが見つからない場合にアクションを実行するように通知されます。 これは、グループ所有者がレビュー担当者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。
$select をサポートします。 メモ： このプロパティは 、fallbackReviewers に置き換えられました。 ただし、 backupReviewers または fallbackReviewers を指定すると、同じ値が他のプロパティに自動的に設定されます。 |
| createdBy | Useridentity | このレビューを作成したユーザー。 読み取り専用です。 |
| createdDateTime | DateTimeOffset | アクセス レビュー シリーズが作成されたときのタイムスタンプ。
$select をサポートしています。 読み取り専用です。 |
| descriptionForAdmins | String | レビュー作成者が提供する説明。管理者にレビューのコンテキストを追加します。
$select をサポートします。 |
| descriptionForReviewers | String | レビュー作成者によって提供される説明。レビュー担当者にレビューのより多くのコンテキストを提供します。 レビュー担当者は、レビューを要求するメールにこの説明を表示します。 Email通知では、最大 256 文字がサポートされます。
$select をサポートしています。 |
| displayName | String | アクセス レビュー シリーズの名前。
$select と $orderby をサポートします。 作成時に必要です。 |
| fallbackReviewers | accessReviewReviewerScope コレクション | このレビュー担当者スコープのコレクションは、フォールバック レビュー担当者の一覧を定義するために使用されます。 これらのフォールバック レビュー担当者は、指定されたレビュー担当者の一覧からユーザーが見つからない場合にアクションを実行するように通知されます。 これは、グループ所有者がレビュー担当者として指定されているが、グループ所有者が存在しない場合、またはマネージャーがレビュー担当者として指定されているが、ユーザーのマネージャーが存在しない場合に発生する可能性があります。
accessReviewReviewerScope に関するページを参照してください。
backupReviewers を置き換えます。
$select をサポートします。 メモ： フォールバック レビュー担当者が stageSettings プロパティを使用して割り当てられている場合、このプロパティの値は無視されます。 |
| id | String | アクセス レビューの機能割り当て一意識別子。
$select をサポートしています。 読み取り専用です。 |
| instanceEnumerationScope | accessReviewScope | このプロパティは、すべての Microsoft 365 グループにわたるゲスト ユーザーのアクセスにレビューをスコープし、レビューする Microsoft 365 グループを決定する場合に必要です。 各グループは、アクセス レビュー シリーズの一意の accessReviewInstance になります。 サポートされているスコープについては、「 accessReviewScope」を参照してください。
$select をサポートします。 instanceEnumerationScope を構成するためのオプションの例については、「Microsoft Graph APIを使用してアクセス レビュー定義のスコープを構成する」を参照してください。 |
| lastModifiedDateTime | DateTimeOffset | アクセス レビュー シリーズが最後に変更されたときのタイムスタンプ。
$select をサポートしています。 読み取り専用です。 |
| レビュー | accessReviewReviewerScope コレクション | このアクセス レビュー スコープのコレクションは、レビュー担当者を定義するために使用されます。 レビュー担当者プロパティは、個々のユーザーがレビュー担当者として割り当てられている場合にのみ更新できます。 作成時に必要です。
$select をサポートします。 レビュー担当者を割り当てるオプションの例については、「Microsoft Graph APIを使用してレビュー担当者をアクセス レビュー定義に割り当てる」を参照してください。 メモ： レビュー担当者が stageSettings プロパティを使用して割り当てられている場合、このプロパティの値は無視されます。 |
| scope | accessReviewScope | アクセス権がレビューされるエンティティを定義します。 サポートされているスコープについては、「 accessReviewScope」を参照してください。 作成時に必要です。 と $filter (containsのみ) がサポートされます$select。 スコープを構成するためのオプションの例については、「Microsoft Graph APIを使用してアクセス レビュー定義のスコープを構成する」を参照してください。 |
| settings | accessReviewScheduleSettings | アクセス レビュー シリーズの設定については、以下の「型の定義」を参照してください。
$select をサポートします。 作成時に必要です。 |
| stageSettings | accessReviewStageSettings コレクション | 複数ステージのアクセス レビューでステージとその設定を定義する場合にのみ必要です。 各レビュー インスタンスを最大 3 つのシーケンシャル ステージに分割できます。各ステージには、異なるレビュー担当者、フォールバック レビュー担当者、設定のセットを含めることができます。 ステージは dependsOn プロパティに基づいて順番に作成されます。 省略可能。 このプロパティを定義すると、accessReviewScheduleDefinition オブジェクトとその設定、レビュー担当者、フォールバックReviewers プロパティの対応する設定の代わりに、その設定が使用されます。 |
| status | String | この読み取り専用フィールドは、アクセス レビューの状態を指定します。 一般的な状態には、、、、、、CompletedAutoReviewingCompletingInProgressおよび が含AutoReviewedまれます。InitializingStartingNotStarted 、、および ( のみ) がサポートされます $select$orderby。eq$filter 読み取り専用。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| 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"
}
],
"instanceEnumerationScope": {
"@odata.type": "microsoft.graph.accessReviewScope"
},
"stageSettings": [
{
"@odata.type": "microsoft.graph.accessReviewStageSettings"
}
],
"settings": {
"@odata.type": "microsoft.graph.accessReviewScheduleSettings"
},
"additionalNotificationRecipients": [
{
"@odata.type": "microsoft.graph.accessReviewNotificationRecipientItem"
}
]
}