Тип ресурса recurrenceRange

Пространство имен: microsoft.graph

Описывает диапазон дат, в течение которого возникает повторяющееся событие. Этот общий объект используется для определения повторения проверок доступа, событий календаря и назначений пакетов доступа в Microsoft Entra ID.

Вы можете задать диапазон дат для повторяющегося события одним из 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 включительно. Повторение события с 1 июня 2017 г. до 15 июня 2017 г. type, startDate, endDate
noEnd Диапазон без даты окончания Событие повторяется во все дни, входящие в соответствующее расписание повторения, начиная с даты startDate. Бесконечное повторение события с 1 июня 2017 г. type, startDate
numbered Диапазон с определенным количеством повторений Событие повторяется определенное количество раз (указанное в numberOfOccurrences) в соответствии с расписанием повторения, начиная с даты startDate. Повторение события 10 раз с 1 июня 2017 г. type, startDate, numberOfOccurrences

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "endDate": "String (timestamp)",
  "numberOfOccurrences": 1024,
  "recurrenceTimeZone": "string",
  "startDate": "String (timestamp)",
  "type": "String"
}