Type de ressource recurrenceRange

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Décrit une plage de dates sur laquelle un événement périodique. Cet objet partagé est utilisé pour définir la périodicité des révisions d’accès, desévénements de calendrier et des affectations de package d’accès dans Microsoft Entra ID.

Vous pouvez spécifier la plage de dates pour un événement récurrent de 3 façons en fonction du cas de figure. Même si vous devez toujours spécifier une valeur startDate pour la plage de dates, vous pouvez spécifier un événement périodique qui se termine à une date spécifique, qui ne se termine pas ou qui se termine après un certain nombre d’occurrences. Notez que les occurrences réelles au sein de la plage de dates suivent toujours la périodicité spécifiée pour l’événement périodique. Un événement périodique est toujours défini par sa périodicité (fréquence à laquelle l’événement se répète) et sa plage de périodicité (durée pendant laquelle l’événement se répète).

Propriétés

Propriété	Type	Description
endDate	Date	Date à laquelle se termine la répétition de l’événement. En fonction de la périodicité de l’événement, la dernière réunion pourra avoir lieu avant cette date. Obligatoire si le type est endDate.
numberOfOccurrences	Int32	Nombre de répétitions de l’événement. Requis et impérativement positif si le type est numbered.
recurrenceTimeZone	Chaîne	Fuseau horaire pour les propriétés startDate et endDate. Facultatif. Si aucun autre fuseau horaire n’est indiqué, c’est celui de l’événement qui est utilisé.
startDate	Date	Date à laquelle commence la répétition de l’événement. La première réunion peut avoir lieu à cette date ou plus tard, selon la périodicité de l’événement. Doit être identique à la propriété start de l’événement récurrent. Obligatoire.
type	String	Plage de périodicité : Les valeurs possibles sont endDate, noEnd, numbered. Obligatoire.

Utilisez la propriété type pour spécifier les différents types de plage de périodicité. Notez les propriétés requises pour chaque type, comme décrit dans le tableau suivant.

type, propriété	Type de plage de périodicité	Description	Exemple	Propriétés requises
endDate	Plage avec date de fin	L’événement se répète tous les jours correspondant à la périodicité, entre la date de début (startDate) et la date de fin (endDate).	Répéter l’événement au sein de la plage de dates allant du 1er juin 2017 au 15 juin 2017.	type, startDate, endDate
noEnd	Plage sans date de fin	L’événement se répète tous les jours qui correspondent à la périodicité, à partir de la date de début.	Répéter l’événement indéfiniment au sein de la plage de dates commençant au 1er juin 2017.	type, startDate
numbered	Plage spécifiant un nombre d’occurrences	L’événement se répète en fonction de la valeur numberOfOccurrences et de la périodicité, à partir de la date de début.	Répéter 10 fois l’événement au sein de la plage de dates commençant au 1er juin 2017.	type, startDate, numberOfOccurrences

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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