Тип ресурса recurrenceRange

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

Вы можете задать диапазон дат для повторяющегося события одним из 3 способов (в зависимости от сценария). Необходимо всегда указывать значение startDate для диапазона дат, но вы можете задать повторяющееся событие, которое перестает повторяться в определенный день либо повторяется бесконечно или определенное количество раз. Обратите внимание, что фактические экземпляры события в диапазоне дат всегда соответствуют расписанию повторения, заданному для повторяющегося события. Повторяющееся событие всегда определяется соответствующими ресурсами recurrencePattern (частотой повторения события) и recurrenceRange (продолжительностью повторения).

Свойства

Свойство	Тип	Описание
endDate	Date	Дата, с которой перестает применяться расписание повторения. В зависимости от того, каково расписание повторения события, последний экземпляр собрания может приходиться на другую дату. Обязательное, если для type задано значение endDate.
numberOfOccurrences	Int32	Количество повторений события. Обязательное свойство, которое должно быть положительным, если для type задано значение numbered.
recurrenceTimeZone	String	Часовой пояс для свойств startDate и endDate. Необязательное. Если это свойство не задано, используется часовой пояс события.
startDate	Date	Дата, с которой начинает применяться расписание повторения. В зависимости от того, каково расписание повторения события, первый экземпляр собрания может приходиться на эту или более позднюю дату. Должно быть задано то же значение, что и для свойства start повторяющегося события. Обязательное.
type	String	Диапазон повторения. Возможные значения: 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"
}