Tipo de recurso recurrenceRange
Espacio de nombres: microsoft.graph
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 | recurrenceRangeType | Intervalo de periodicidad. Los valores posibles son: 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 |
Relaciones
Ninguna.
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"
}