recurrencePattern 资源类型

命名空间:microsoft.graph

描述了定期事件的重复发生频率。 此共享对象用于在 Entra ID Microsoft定义 访问评审日历事件访问包分配 的重复周期。

可以使用下面的 6 种方法之一(具体视方案而定),指定定期事件的定期模式。 对于每种类型的模式,请指定时间间隔。 在为事件指定的日期范围内,实际发生的定期事件始终遵循此模式。 定期事件始终由 recurrencePattern(事件的重复发生频率)和 recurrenceRange(事件在哪个日期范围内重复发生)进行定义。

type 属性可用于指定不同类型的 recurrencePatterninterval 属性可用于指定时间间隔,可以是天数、周数、月数或年数,具体视 type 而定。 请注意每种类型的必需属性,如下表所述。

注意:仅添加定期模式需要的属性。 如果添加的任何属性没有受支持的值,则会引发错误。

属性

属性 类型 说明
dayOfMonth Int32 事件在相应月份的多少号发生。 如果 typeabsoluteMonthlyabsoluteYearly,此为必需属性。
daysOfWeek dayOfWeek 集合 事件在星期几(一系列值)发生。 可取值包括:sundaymondaytuesdaywednesdaythursdayfridaysaturday
如果 typerelativeMonthlyrelativeYearly,且 daysOfWeek 指定超过一天,事件遵循相应模式的第一天规则。
如果 typeweeklyrelativeMonthlyrelativeYearly,此为必需属性。
firstDayOfWeek dayOfWeek 周的第一天。 可取值包括:sundaymondaytuesdaywednesdaythursdayfridaysaturday。 默认值为“sunday”。 如果 typeweekly,此为必需属性。
index weekIndex 指定事件发生在 daysOfWeek 中指定的允许天数实例的哪个实例上,从当月的第一个实例计数。 可能的值包括 firstsecondthirdfourthlast。 默认值为“first”。 如果 typerelativeMonthlyrelativeYearly,请使用此可选属性。
interval Int32 间隔的单元数,可以是天数、周数、月数或年数,具体视 type 而定。 此为必需属性。
month Int32 事件发生的月份。 这是一个介于 1 到 12 之间的数字。
type recurrencePatternType 定期模式类型:dailyweeklyabsoluteMonthlyrelativeMonthlyabsoluteYearlyrelativeYearly。 必填。 有关详细信息,请参阅 类型属性的值

重要

对于访问评审,仅支持 dayOfMonthintervaltype (weekly) absoluteMonthly 属性。

类型属性的值

type 属性值 说明 示例 必需属性
daily 事件按 interval 指定的时间间隔天数重复发生。 事件每 3 天重复发生一次。 typeinterval
weekly 事件按时间间隔周数在一周内的一天或几天重复发生。 事件每两个星期一和星期二重复发生一次。 typeintervaldaysOfWeekfirstDayOfWeek

注意: 对于访问评审,仅支持 间隔类型 属性。
absoluteMonthly 事件按时间间隔月数在相应月份的指定一天(例如 15 号)重复发生。 事件每季度(每 3 个月)的 15 号重复发生一次。 typeintervaldayOfMonth

注意: 对于访问评审,仅支持 intervaldayOfMonth类型 属性。
relativeMonthly 事件按时间间隔月数在一周内的指定一天或几天(相应月份的同一相对位置)重复发生。 事件每 3 个月的第二个星期四或星期五重复发生一次。 typeintervaldaysOfWeek
absoluteYearly 事件按时间间隔年数在指定月份的一天重复发生。 事件每 3 年在 3 月 15 日重复发生一次。 typeintervaldayOfMonthmonth
relativeYearly 事件按时间间隔年数在一周内的指定一天或几天(相应年份和月份的同一相对位置)重复发生。 事件每 3 年在 11 月的第二个星期四或星期五重复发生一次。 typeintervaldaysOfWeekmonth

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "dayOfMonth": 1024,
  "daysOfWeek": ["String"],
  "firstDayOfWeek": "String",
  "index": "String",
  "interval": 1024,
  "month": 1024,
  "type": "String"
}