次の方法で共有


accessReviewScheduleSettings リソースの種類

名前空間: microsoft.graph

重要

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

注:

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

accessReviewScheduleSettings、accessReviewScheduleDefinition の設定を定義します。

プロパティ

プロパティ 説明
mailNotificationsEnabled ブール型 メールが有効か無効かを示します。 既定値は、false です。
reminderNotificationsEnabled ブール型 アラームが有効か無効かを示します。 既定値は、false です。
justificationRequiredOnApproval ブール型 レビュー担当者が判断に正当な理由を提供する必要があるかどうかを示します。 既定値は、false です。
defaultDecisionEnabled ブール型 レビュー担当者が応答しない場合に、既定の決定が有効か無効かを示します。 既定値は、false です。

注意:autoApplyDecisionsEnableddefaultDecisionEnabled の両方がtrueされている場合、校閲者が応答しなかった場合、リソースに対するすべてのアクセスが取り消されるリスクがあります。
defaultDecision String defaultDecisionEnabledが有効になっている場合に選択された決定。 ApproveDeny、またはRecommendationのいずれかです。
instanceDurationInDays Int32 レビューの各繰り返しの期間 (accessReviewInstance) (日数)。
手記:accessReviewScheduleDefinition オブジェクトの stageSettings が定義されている場合、このプロパティの値の代わりに durationInDays 設定が使用されます。
recurrence patternedRecurrence 標準の Outlook 定期的なオブジェクトを使用した繰り返しの詳細な設定。

手記:サポートされるのは、dayOfMonthinterval、type (weeklyabsoluteMonthly) プロパティのみです。 recurrenceRangestartDate プロパティを使用して、レビューの開始日を決定します。
autoApplyDecisionsEnabled ブール型 決定が自動的に適用されるかどうかを示します。 falseに設定されている場合、レビュー担当者がアクセス レビューを完了したら、管理者が意思決定を手動で適用する必要があります。 trueに設定すると、レビュー担当者が応答したかどうかにかかわらず、アクセス レビュー インスタンスの期間が終了すると、決定が自動的に適用されます。 既定値は、false です。

注意:autoApplyDecisionsEnableddefaultDecisionEnabled の両方がtrueされている場合、校閲者が応答しなかった場合、リソースに対するすべてのアクセスが取り消されるリスクがあります。
applyActions accessReviewApplyAction コレクション 省略可能なフィールド。 レビューが完了したら実行するアクションについて説明します。 現在サポートされているのは、 removeAccessApplyAction (既定値) と disableAndDeleteUserApplyActionの 2 種類です。 フィールドは、 disableAndDeleteUserApplyActionの場合にのみ指定する必要があります。
recommendationsEnabled ブール型 意思決定の推奨事項が有効か無効かを示します。
手記:accessReviewScheduleDefinition オブジェクトの stageSettings が定義されている場合、このプロパティの値の代わりに recommendationsEnabled 設定が使用されます。
recommendationLookBackDuration 期間 省略可能なフィールド。 推奨事項が構成される非アクティブ期間 (レビュー インスタンスの開始日に関する) を示します。 ユーザーがルックバック期間中に非アクティブな場合は、 deny することをお勧めします。 グループと Microsoft Entra ロールのレビューでは、任意の期間が受け入れられます。 アプリケーションのレビューの場合、最大期間は 30 日です。 指定しない場合、期間は 30 日です。

手記:accessReviewScheduleDefinition オブジェクトの stageSettings が定義されている場合、このプロパティの値の代わりに recommendationLookBackDuration 設定が使用されます。
decisionHistoriesForReviewersEnabled ブール型 以前のアクセス レビュー ステージに関する決定を accessReviewInstance のレビュー担当者が複数の後続のステージで使用できるかどうかを示します。 指定しない場合、既定値は無効になります (false)。
recommendationInsightSettings accessReviewRecommendationInsightSetting コレクション 省略可能。 レビュー担当者がアクセス レビューの決定を行うのに役立つ分析情報の種類について説明します。

手記:accessReviewScheduleDefinition オブジェクトの stageSettings が定義されている場合、このプロパティの値の代わりに、その recommendationInsightSettings 設定が使用されます。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.accessReviewScheduleSettings",
  "mailNotificationsEnabled": "Boolean",
  "reminderNotificationsEnabled": "Boolean",
  "justificationRequiredOnApproval": "Boolean",
  "defaultDecisionEnabled": "Boolean",
  "defaultDecision": "String",
  "instanceDurationInDays": "Integer",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "autoApplyDecisionsEnabled": "Boolean",
  "applyActions": [
    {
      "@odata.type": "microsoft.graph.removeAccessApplyAction"
    }
  ],
  "recommendationsEnabled": "Boolean",
  "recommendationLookBackDuration": "String (duration)",
  "decisionHistoriesForReviewersEnabled": "Boolean",
  "recommendationInsightSettings": [
    {
      "@odata.type": "microsoft.graph.accessReviewRecommendationInsightSetting"
    }
  ]
}