Tipo de recurso recurrenceRange

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Describe un intervalo de fechas sobre el que 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 intervalo de fechas para un evento periódico de tres maneras según su situación. Aunque siempre debe especificar un valor startDate para el intervalo de fechas, puede especificar un evento periódico que finaliza en una fecha específica, que no termina o que finaliza tras un número específico de repeticiones. Tenga en cuenta que las repeticiones reales dentro del intervalo de fechas siempre seguirán el patrón de periodicidad que especifique para el evento periódico. 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).

Propiedades

Propiedad	Tipo	Descripción
endDate	Fecha	Fecha en la que se detiene la aplicación del patrón de periodicidad. Según el patrón de periodicidad del evento, la última repetición de la reunión no puede ser esta fecha. Se requiere si type es endDate.
numberOfOccurrences	Int32	Número de veces que se repite el evento. Se requiere y debe ser positivo si type es numbered.
recurrenceTimeZone	String	Zona horaria de las propiedades startDate y endDate. Opcional. Si no se especifica, se usa la zona horaria del evento.
startDate	Fecha	Fecha en la que se inicia la aplicación del patrón de periodicidad. La primera repetición de la reunión puede ser esta fecha o una posterior, en función del patrón de periodicidad del evento. Debe ser el mismo valor que la propiedad start del evento periódico. Obligatorio.
type	Cadena	Intervalo de periodicidad. Valores posibles: endDate, noEnd, numbered. Obligatorio.

Use la propiedad type para especificar los diferentes tipos de recurrenceRange. Tenga en cuenta las propiedades necesarias para cada tipo, tal como se describe en la tabla siguiente.

Propiedad type	Tipo de intervalo de frecuencia	Descripción	Ejemplo	Propiedades requeridas
endDate	Rango con fecha final	El evento se repetirá durante todos los días que formen parte del patrón de frecuencia correspondiente, entre los valores startDate y endDate, ambos incluidos.	Repite el evento en el intervalo de fechas entre el 1 de junio de 2017 y el 15 de junio de 2017.	type, startDate, endDate
noEnd	Intervalo sin fecha final	El evento se repetirá todos los días que formen parte del patrón de frecuencia correspondiente, que empieza el startDate.	Repite indefinidamente el evento en el intervalo de fechas a partir del 1 de junio de 2017.	type, startDate
numbered	Intervalo con un número de repeticiones concreto	El evento se repite según el valor numberOfOccurrences, que se basa en el patrón de frecuencia que empieza en el momento especificado en startDate.	Repita el evento 10 veces en el intervalo de fechas a partir del 1 de junio de 2017.	type, startDate, numberOfOccurrences

Representación JSON

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

{
  "endDate": "String (timestamp)",
  "numberOfOccurrences": 1024,
  "recurrenceTimeZone": "string",
  "startDate": "String (timestamp)",
  "type": "String"
}