大网数据广告活动
Microsoft Graph 接口

recurrencePattern 资源类型

· 52CE 我爱测

描述了定期事件的重复发生频率。

命名空间:microsoft.graph

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

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

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

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

属性

属性 类型 说明
dayOfMonth Int32 事件在相应月份的多少号发生。 如果 type 为 absoluteMonthly 或 absoluteYearly,此为必需属性。
daysOfWeek dayOfWeek 集合 事件在星期几(一系列值)发生。 可取值包括:sunday、monday、tuesday、wednesday、thursday、friday、saturday。 如果 type 为 relativeMonthly 或 relativeYearly,且 daysOfWeek 指定超过一天,事件遵循相应模式的第一天规则。 如果 type 为 weekly、relativeMonthly 或 relativeYearly,此为必需属性。
firstDayOfWeek dayOfWeek 周的第一天。 可取值包括:sunday、monday、tuesday、wednesday、thursday、friday、saturday。 默认值为 sunday。 如果 type 为 weekly,此为必需属性。
index weekIndex 指定在 daysOfWeek 中指定的允许天数的实例发生,从当月的第一个实例开始计数。 可能的值包括 first、second、third、fourth、last。 默认值为 first。 如果 type 为 relativeMonthly 或 relativeYearly,请使用此可选属性。
interval Int32 间隔的单元数,可以是天数、周数、月数或年数,具体视 type 而定。 此为必需属性。
month Int32 事件发生的月份。 这是一个介于 1 到 12 之间的数字。
type recurrencePatternType 定期模式类型:daily、weekly、absoluteMonthly、relativeMonthly、absoluteYearly 或 relativeYearly。 此为必需属性。 有关详细信息,请参阅 类型属性的值。

Important: 对于访问评审,仅 支持 dayOfMonth 、interval 和 type (weekly absoluteMonthly ,) 属性。

type 属性的值

type 属性值 说明 示例 必需属性
daily 事件按 interval 指定的时间间隔天数重复发生。 事件每 3 天重复发生一次。 type、interval
weekly 事件按时间间隔周数在一周内的一天或几天重复发生。 事件每两个星期一和星期二重复发生一次。 type、interval、daysOfWeek、firstDayOfWeek 注意: 对于访问评审, 仅支持 interval 和 type 属性。
absoluteMonthly 事件按时间间隔月数在相应月份的指定一天(例如 15 号)重复发生。 事件每季度(每 3 个月)的 15 号重复发生一次。 type、interval、dayOfMonth 注意: 对于访问评审,仅支持 interval 、dayOfMonth****和 type 属性。
relativeMonthly 事件按时间间隔月数在一周内的指定一天或几天(相应月份的同一相对位置)重复发生。 事件每 3 个月的第二个星期四或星期五重复发生一次。 type、interval、daysOfWeek
absoluteYearly 事件按时间间隔年数在指定月份的一天重复发生。 事件每 3 年在 3 月 15 日重复发生一次。 type、interval、dayOfMonth、month
relativeYearly 事件按时间间隔年数在一周内的指定一天或几天(相应年份和月份的同一相对位置)重复发生。 事件每 3 年在 11 月的第二个星期四或星期五重复发生一次。 type、interval、daysOfWeek、month

JSON 表示形式

下面是资源的 JSON 表示形式。

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

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 harini84)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。