recurrenceRange 资源类型
命名空间：microsoft.graph
描述定期事件的日期范围。 此共享对象用于在 Entra ID Microsoft定义 访问评审、 日历事件和 访问包分配 的重复周期。
可以使用下面的 3 种方法之一（具体视方案而定），指定定期事件的日期范围。 虽然必须始终指定日期范围的 startDate 值，但定期事件的结束日期可以有多种指定方法。可以指定定期事件在特定日期前结束、没有结束日期或在重复发生特定次数后结束。 请注意，在日期范围内，实际发生的定期事件始终遵循为事件指定的定期模式。 定期事件始终由 recurrencePattern（事件的重复发生频率）和 recurrenceRange（事件在哪个日期范围内重复发生）进行定义。
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| endDate | Date | 定期模式的停止应用日期。 会议的最后一次发生时间可能不是此日期，具体视事件的定期模式而定。 如果 type 为 endDate，此为必需属性。 |
| numberOfOccurrences | Int32 | 事件重复发生次数。 如果 type 为 numbered，此为必需属性，且必须为正数。 |
| recurrenceTimeZone | String | startDate 和 endDate 属性的时区。 此为可选属性。 如果未指定，使用的是事件时区。 |
| startDate | Date | 定期模式的开始应用日期。 会议的第一次发生时间可能是此日期，也可能晚于此日期，具体视事件的定期模式而定。 必须与定期事件的 start 属性值相同。 此为必需属性。 |
| type | recurrenceRangeType | 定期范围。 可能的值包括 endDate、noEnd、numbered。 必填。 |
type 属性可用于指定不同类型的 recurrenceRange。 请注意每种类型的必需属性，如下表所述。
| type 属性 | 定期范围类型 | 说明 | 示例 | 必需属性 |
|---|---|---|---|---|
endDate |
有结束日期的范围 | 事件在 startDate 到 endDate（含边界值）之间遵循相应的定期模式重复发生。 | 事件在日期范围 2017 年 6 月 1 日到 2017 年 6 月 15 日之间重复发生。 | type、startDate、endDate |
noEnd |
无结束日期的范围 | 事件从 startDate 起遵循相应的定期模式重复发生。 | 事件在从 2017 年 6 月 1 日起的无限期日期范围内重复发生。 | type、startDate |
numbered |
指定了特定发生次数的范围 | 从 startDate 起，事件遵循定期模式重复发生 numberOfOccurrences 次。 | 事件在从 2017 年 6 月 1 日起的日期范围内重复发生 10 次。 | type、startDate、numberOfOccurrences |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"endDate": "String (timestamp)",
"numberOfOccurrences": 1024,
"recurrenceTimeZone": "string",
"startDate": "String (timestamp)",
"type": "String"
}