Type de ressource recurrencePattern
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 la fréquence à laquelle un événement périodique se répète. 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 périodicité d’un événement périodique de 6 façons en fonction de votre scénario. Pour chaque type de modèle, spécifiez le délai entre chaque occurrence. Les occurrences réelles de l’événement périodique suivent toujours ce modèle en s’inscrivant dans la plage de dates spécifiée pour l’événement. 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).
Utilisez la propriété type pour spécifier les différents types de périodicité, et la propriété interval pour spécifier le délai entre chaque occurrence (en nombre de jours, semaines, mois ou années selon le type). Notez les propriétés requises pour chaque type, comme décrit dans le tableau suivant.
Remarque Incluez uniquement les propriétés nécessaires à une périodicité. Si une propriété n’a pas une valeur prise en charge, une erreur est générée.
Propriétés
| Propriété | Type | Description |
|---|---|---|
| dayOfMonth | Int32 | Jour du mois où l’événement se produit. Obligatoire si le type est absoluteMonthly ou absoluteYearly. |
| daysOfWeek | Collection dayOfWeek | Collection des jours de la semaine où l’événement se produit. Les valeurs possibles sont sunday, monday, tuesday, wednesday, thursday, friday, saturday. Si le type est relativeMonthly ou relativeYearly, et que plusieurs jours sont définis pour daysOfWeek, l’événement tombe sur le premier jour conforme au modèle. Obligatoire si type est weekly, relativeMonthly ou relativeYearly. |
| firstDayOfWeek | dayOfWeek | Premier jour de la semaine Les valeurs possibles sont sunday, monday, tuesday, wednesday, thursday, friday, saturday. La valeur par défaut est sunday. Obligatoire si type est weekly. |
| index | weekIndex | Spécifie sur quelle instance des jours autorisés spécifiés dans daysOfWeek l’événement se produit, compté à partir de la première instance du mois. Les valeurs possibles sont : first, second, third, fourth, last. La valeur par défaut est first. Facultatif, utile si le type est relativeMonthly ou relativeYearly. |
| interval | Int32 | Nombre d’unités entre chaque occurrence, où les unités peuvent être en jours, semaines, mois ou années selon le type. Obligatoire. |
| month | Int32 | Mois où l’événement se produit. Il s’agit d’un nombre compris entre 1 et 12. |
| type | recurrencePatternType | Type de périodicité : daily, weekly, absoluteMonthly, relativeMonthly, absoluteYearly, relativeYearly. Obligatoire. Pour plus d’informations, consultez les valeurs de la propriété de type. |
Importante
Pour les révisions d’accès, seules les propriétés dayOfMonth, interval et type (weekly, absoluteMonthly) sont prises en charge.
Valeurs de la propriété de type
| Valeur de la propriété de type | Description | Exemple | Propriétés requises |
|---|---|---|---|
daily |
L’événement se répète en fonction du nombre de jours spécifié par l’intervalle entre chaque occurrence. | Répéter l’événement tous les 3 jours. | type, interval |
weekly |
L’événement se répète toujours le(s) même(s) jour(s) de la semaine, selon un intervalle défini en nombre de semaines. | Répétez l’événement lundi et mardi toutes les deux semaines. |
type, interval, daysOfWeek, firstDayOfWeek Note: Pour les révisions d’accès, seules les propriétés d’intervalle et de type sont prises en charge. |
absoluteMonthly |
L’événement se répète toujours le même le jour du mois (par exemple, le 15), selon un intervalle défini en nombre de mois. | Répéter l’événement chaque trimestre (tous les trois mois), le 15 du mois. |
type, interval, dayOfMonth Note: Pour les révisions d’accès, seules les propriétés interval, dayOfMonth et type sont prises en charge. |
relativeMonthly |
L’événement se répète le(s) jour(s) de la semaine spécifié(s), à la même position relative dans le mois, selon un intervalle défini en nombre de mois. | Répéter l’événement le deuxième jeudi ou vendredi du mois, tous les trois mois. | type, interval, daysOfWeek |
absoluteYearly |
L’événement se répète à la date (jour et mois) spécifiée, selon un intervalle défini en nombre d’années. | Répéter l’événement le 15 mars, tous les 3 ans. | type, interval, dayOfMonth, month |
relativeYearly |
L’événement se répète le(s) jour(s) de la semaine spécifié(s), à la même position relative dans un mois de l’année, selon un intervalle défini en nombre d’années. | Répéter l’événement le deuxième jeudi ou vendredi de chaque novembre, tous les 3 ans. | type, interval, daysOfWeek, month |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"dayOfMonth": 1024,
"daysOfWeek": ["String"],
"firstDayOfWeek": "String",
"index": "String",
"interval": 1024,
"month": 1024,
"type": "String"
}