Тип ресурса recurrenceRange
Пространство имен: microsoft.graph
Описывает диапазон дат, в течение которого возникает повторяющееся событие. Этот общий объект используется для определения повторения проверок доступа, событий календаря и назначений пакетов доступа в идентификаторе Microsoft Entra.
Вы можете задать диапазон дат для повторяющегося события одним из 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"
}