Compartir a través de


Tipo de recurso recurrencePattern

Espacio de nombres: microsoft.graph

Describe la frecuencia con la que se repite un evento periódico. Este objeto compartido se usa para definir la periodicidad de las revisiones de acceso, los eventos de calendario y las asignaciones de paquetes de acceso en Microsoft Entra ID.

Puede especificar el patrón de periodicidad de un evento periódico siguiendo uno de los seis métodos según su situación. Para cada tipo de patrón, especifique la cantidad de tiempo entre las repeticiones. Las repeticiones actuales del evento periódico siempre seguirán este patrón, y se limitarán al intervalo de fechas que especifique para el evento. Un evento periódico siempre se define por su valor recurrencePattern (con qué frecuencia se repite el evento) y su valor recurrenceRange (durante cuánto tiempo se repite el evento).

Use la propiedad type para especificar los diferentes tipos de recurrencePattern y la propiedad interval para especificar el tiempo entre las repeticiones. Puede hacerlo de varios modos: especificando días, semanas, meses o años en función del valor type. Tenga en cuenta las propiedades necesarias para cada tipo, tal como se describe en la tabla siguiente.

Nota: Incluya únicamente las propiedades que necesita para un patrón de periodicidad. Cualquier propiedad que incluya que no tenga un valor admitido hará que se produzca un error.

Propiedades

Propiedad Tipo Descripción
dayOfMonth Int32 Día del mes en el que se produce el evento. Se requiere si type es absoluteMonthly o absoluteYearly.
daysOfWeek dayOfWeek (colección) Colección de los días de la semana en los que se produce el evento. Los valores posibles son: sunday, monday, tuesday, wednesday, thursday, friday y saturday.
Si type es relativeMonthly o relativeYearly, y daysOfWeek especifica más de un día, el evento ocurre en el primer día que cumpla con el patrón.
Se requiere si type es weekly, relativeMonthly o relativeYearly.
firstDayOfWeek dayOfWeek Primer día de la semana. Los valores posibles son: sunday, monday, tuesday, wednesday, thursday, friday y saturday. El valor predeterminado es sunday. Se requiere si type es weekly.
index weekIndex Especifica en qué instancia de los días permitidos especificados en daysOfWeek se produce el evento, que se cuenta desde la primera instancia del mes. Los valores posibles son: first, second, third, fourth, last. El valor predeterminado es first. Es opcional y se usa si type es relativeMonthly o relativeYearly.
interval Int32 El número de unidades entre repeticiones, donde las unidades pueden ser días, semanas, meses o años, dependiendo de type. Obligatorio.
mes Int32 Mes en el que se produce el evento. Se trata de un número entre 1 y 12.
type recurrencePatternType Tipo de patrón de periodicidad: daily, weekly, absoluteMonthly, relativeMonthly, absoluteYearly, relativeYearly. Obligatorio. Para obtener más información, vea valores de la propiedad type.

Importante

Para las revisiones de acceso, solo se admiten las propiedades dayOfMonth, interval y type (weekly, absoluteMonthly).

Valores de la propiedad type

Valor de la propiedad type Descripción Ejemplo Propiedades requeridas
daily El evento se repite según el número de días especificados en el valor interval entre repeticiones. Repita el evento cada tres días. type, interval
weekly El evento se repetirá el mismo día o los mismos días de la semana, en función del número de semanas entre cada conjunto de repeticiones. Repita el evento los lunes y martes de cada dos semanas. type, interval, daysOfWeek, firstDayOfWeek

Nota: Para las revisiones de acceso, solo se admiten las propiedades de intervalo y tipo .
absoluteMonthly El evento se repite el día del mes especificado (por ejemplo, el día 15), en función del número de meses entre las repeticiones. Repita este evento de forma trimestral (cada tres meses) el día 15. type, interval, dayOfMonth

Nota: Para las revisiones de acceso, solo se admiten las propiedades interval, dayOfMonth y type .
relativeMonthly El evento se repite el día o los días de la semana especificados, en la misma posición relativa del mes, en función del número de meses entre las repeticiones. Repita el evento el segundo jueves y viernes de cada trimestre. type, interval, daysOfWeek
absoluteYearly El evento se repite el día y el mes especificados, en función del número de años entre repeticiones. Repita el evento el 15 de marzo cada tres meses. type, interval, dayOfMonth, month
relativeYearly El evento se repite el día o los días de la semana especificados, en la misma posición relativa del mes del año específico, en función del número de años entre repeticiones. Repita el evento el segundo jueves y viernes de noviembre cada tres años. type, interval, daysOfWeek, month

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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