Type de ressource recurrenceRange
Espace de noms: microsoft.graph
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 attributions de package d’accès dans l’ID Microsoft Entra.
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 | recurrenceRangeType | 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 |
Relations
Aucun.
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"
}