Тип ресурса recurrencePattern

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

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

В зависимости от того, каков конкретный сценарий, вы можете задать расписание повторения события одним из 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. Обязательно. Дополнительные сведения см. в разделе значения свойства type.

Важно!

Для проверок доступа поддерживаются только свойства 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	Событие повторяется в указанные дни одной и той же (по счету) недели месяца в соответствии с количеством месяцев между повторениями.	Повторение события во второй четверг или вторую пятницу каждые три месяца.	type, interval, daysOfWeek
absoluteYearly	Событие повторяется в указанный день указанного месяца в соответствии с количеством лет между повторениями.	Повторение события 15 марта каждые 3 года.	type, interval, dayOfMonth, month
relativeYearly	Событие повторяется в указанные дни одной и той же (по счету) недели определенного месяца в соответствии с количеством лет между повторениями.	Повторение события во второй четверг или вторую пятницу ноября каждые 3 года.	type, interval, daysOfWeek, month

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

Ниже указано представление ресурса в формате JSON.

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