Поделиться через


Тип ресурса recurrencePattern

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

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

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