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 (weekly, absoluteMonthly) プロパティのみがサポートされています。 recurrenceRangestartDate プロパティを使用して、レビューの開始日を決定します。
autoApplyDecisionsEnabled Boolean 決定が自動的に適用されるかどうかを示します。 に 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"
    }
  ]
}