accessReviewScheduleSettings 资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

注意

这是建议用于访问评审的 API。 以前版本的 访问评审 API 已弃用。

accessReviewScheduleSettings 定义 accessReviewScheduleDefinition 的设置。

属性

属性 类型 说明
mailNotificationsEnabled 布尔值 指示是启用还是禁用电子邮件。 默认值为 false
reminderNotificationsEnabled 布尔值 指示是启用还是禁用提醒。 默认值为 false
justificationRequiredOnApproval 布尔值 指示是否要求审阅者为其决策提供理由。 默认值为 false
defaultDecisionEnabled 布尔值 指示在审阅者不响应时是启用还是禁用默认决策。 默认值为 false

谨慎: 如果 autoApplyDecisionsEnableddefaultDecisionEnabled 均为 true,则如果审阅者无法响应,则主体对资源的所有访问都存在被撤销的风险。
defaultDecision String 选择是否 defaultDecisionEnabled 启用的决策。 可以是 、 DenyRecommendation中的Approve一个。
instanceDurationInDays Int32 每次重复评审的持续时间 (accessReviewInstance) 天数。
注意:如果定义了 accessReviewScheduleDefinition 对象的 stageSettings,则将使用其 durationInDays 设置,而不是此属性的值。
recurrence patternedRecurrence 使用标准 Outlook 定期对象定期的详细设置。

注意: 仅支持 dayOfMonthintervaltype (weekly) absoluteMonthly 属性。 使用 recurrenceRange 上的 startDate 属性确定评审开始的日期。
autoApplyDecisionsEnabled 布尔值 指示是否自动应用决策。 如果设置为 false,则管理员必须在审阅者完成访问评审后手动应用决策。 如果设置为 true,则无论审阅者是否已响应,在访问评审实例持续时间结束后,都会自动应用决策。 默认值为 false

谨慎: 如果 autoApplyDecisionsEnableddefaultDecisionEnabled 均为 true,则如果审阅者无法响应,则主体对资源的所有访问都存在被撤销的风险。
applyActions accessReviewApplyAction 集合 可选字段。 描述评审完成后要执行的操作。 目前支持两种类型: removeAccessApplyAction (默认) 和 disableAndDeleteUserApplyAction。 只需在 的情况下 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"
    }
  ]
}