• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la [documentation Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Référence : Expressions Cron et Rate pour Systems Manager
<a name="reference-cron-and-rate-expressions"></a>

Lorsque vous créez une State Manager association ou une fenêtre de maintenance dans AWS Systems Manager, vous spécifiez un calendrier d'exécution de la fenêtre ou de l'association. Vous pouvez spécifier une planification sous la forme d'une entrée temporelle, appelée *expression cron* ou une entrée basée sur la fréquence appelée *expression de fréquence*. 

## Informations générales sur les expressions cron et rate
<a name="reference-cron-and-rate-expressions-intro"></a>

Les informations suivantes s'appliquent aux expressions cron et rate pour les fenêtres de maintenance et les associations.

**Planification en un seul cycle**  
Lorsque vous créez une association ou une fenêtre de maintenance, vous pouvez spécifier un horodatage au format UTC (temps universel coordonné) afin qu'il s'exécute une fois à l'heure spécifiée. Par exemple : `"at(2020-07-07T15:55:00)"`

**Décalages de planification**  
Les associations et les fenêtres de maintenance prennent en charge les *décalages de planification* pour les expressions CRON uniquement. Un décalage de planification est le nombre de jours à attendre après la date et l'heure spécifiées par une expression CRON avant d'exécuter l'association ou la fenêtre de maintenance.   
Dans la commande suivante, l’expression cron planifie une fenêtre de maintenance à exécuter le troisième mardi de chaque mois à 23 h 30. Cependant, en raison du décalage horaire qui est `2`, la fenêtre de maintenance ne s’exécutera qu’à 23 h 30 deux jours plus tard.  

```
aws ssm create-maintenance-window \
    --name "My-Cron-Offset-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "cron(30 23 ? * TUE#3 *)" \
    --duration 4 \
    --cutoff 1 \
    --schedule-offset 2
```
Dans la commande suivante, l’expression cron planifie l’exécution d’une association le deuxième jeudi de chaque mois. Cependant, en raison du décalage horaire qui est `3`, l’association ne fonctionnera que le dimanche suivant, trois jours plus tard.  

```
aws ssm create-association \
    --name "AWS-UpdateSSMAgent" \
    --targets "Key=instanceids,Values=i-0cb2b964d3e14fd9f" \
    --schedule-expression "cron(0 0 ? * THU#2 *)"  \
    --schedule-offset 3
    --apply-only-at-cron-interval
```
Pour utiliser un décalage avec une association, vous devez spécifier l’option `--apply-only-at-cron-interval`. Cette option indique au système de ne pas exécuter d’association immédiatement après sa création.
Si vous créez une association ou une fenêtre de maintenance avec une expression cron qui cible un jour qui est déjà passé dans la période actuelle, mais que vous ajoutez une date de décalage de planification qui tombe dans le futur, l'association ou la fenêtre de maintenance ne s'exécutera pas dans la période. Il entrera en vigueur au cours de la période suivante. Par exemple, si vous spécifiez une expression cron qui aurait exécuté une fenêtre de maintenance hier et ajouté un décalage horaire de deux jours, la fenêtre de maintenance ne s'exécutera pas demain. 

**Champs obligatoires**  
Les expressions cron pour les fenêtres de maintenance comportent six champs obligatoires. Les expressions Cron pour les associations en ont cinq. (State Manager ne prend actuellement pas en charge la spécification de mois dans les expressions cron pour les associations.) Un champ supplémentaire, le champ `Seconds` (le premier dans une expression cron), est facultatif. Ces champs sont séparés par un espace.    
**Exemples d'expressions cron**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html)
Day-of-week les plages (telles que`MON-FRI`) et les listes de jours séparées par des virgules (telles que`MON,TUE,WED`) sont prises en charge uniquement pour les fenêtres de maintenance. Pour les associations, vous devez spécifier un jour unique (par exemple`MON`) ou utiliser `*` pour tous les jours.

**Valeurs prises en charge**  
Le tableau suivant montre les valeurs prises en charge pour les entrées cron obligatoires.    
**Valeurs prises en charge pour les expressions cron**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html)
Vous ne pouvez pas spécifier de valeur dans les champs day-of-month et dans les day-of-week champs d'une même expression cron. Si vous spécifiez une valeur dans l'un de ces champs, vous devez utiliser un signe ? (point d'interrogation) dans l'autre.

**Caractères génériques pour les expressions cron**  
Le tableau suivant présente les valeurs de caractères génériques que les expressions cron prennent en charge.  
Les expressions cron qui entraînent des fréquences d'une rapidité supérieure à cinq (5) minutes ne sont pas prises en charge. Support pour spécifier à la fois un day-of-week et une day-of-month valeur n'est pas complet. Utilisez un point d'interrogation « ? » dans l'un de ces champs.   
**Caractères génériques pris en charge pour les expressions cron**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html)

**Expressions de fréquence**  
Les expressions de fréquence comportent deux champs obligatoires. Ces champs sont séparés par un espace.    
**Champs obligatoires pour les expression rate**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html)
Si la valeur est égale à `1`, l'unité doit être au singulier. De même, pour les valeurs supérieures à `1`, l'unité doit être au pluriel. Par exemple, `rate(1 hours)` et `rate(5 hour)` ne sont pas valides, mais `rate(1 hour)` et `rate(5 hours)` sont valides.

**Topics**
+ [Informations générales sur les expressions cron et rate](#reference-cron-and-rate-expressions-intro)
+ [Expressions cron et rate pour les associations](#reference-cron-and-rate-expressions-association)
+ [Expressions cron et rate pour les fenêtres de maintenance](#reference-cron-and-rate-expressions-maintenance-window)

## Expressions cron et rate pour les associations
<a name="reference-cron-and-rate-expressions-association"></a>

Cette section inclut des exemples d'expressions cron et rate pour les associations State Manager. Avant de créer l'une de ces expressions, soyez conscient des informations suivantes :
+ Les associations prennent en charge les expressions cron suivantes : toutes les 1/2, 1, 2, 4, 8 ou 12 heures ; chaque jour, chaque semaine, ou chaque jour et heure précisés de la semaine ; un jour précis dans une semaine précise du mois ou le dernier jour `x` du mois à une heure précise. 
+ Les associations prennent en charge les expressions rate suivantes : intervalles de 30 minutes ou plus et moins de 31 jours.
+ Si vous spécifiez le champ facultatif `Seconds`, sa valeur peut être 0 (zéro). Par exemple : `cron(0 */30 * * * ? *)`
+ Pour une association qui collecte des métadonnées pour Inventory, un outil AWS Systems Manager, nous recommandons d'utiliser une expression de débit.
+ State Manager ne prend actuellement pas en charge la spécification de mois dans les expressions cron pour les associations.

Les associations prennent en charge les expressions cron qui incluent un jour de la semaine et le signe numérique (\$1) pour désigner le *n*ième jour d'un mois pour diriger une association. Voici un exemple qui exécute une planification cron le troisième mardi de chaque mois à 23 h 30 UTC :

`cron(30 23 ? * TUE#3 *)`

Voici un exemple qui se déroule le deuxième jeudi de chaque mois à minuit UTC :

`cron(0 0 ? * THU#2 *)`

Les associations soutiennent également le signe (L) pour indiquer le dernier *X* jour du mois. Voici un exemple qui exécute une planification cron le dernier mardi de chaque mois à 23 h 30 UTC :

`cron(0 0 ? * 3L *)`

Pour contrôler davantage l'exécution d'une association, par exemple si vous souhaitez exécuter une association deux jours après le correctif mardi, vous pouvez spécifier un décalage. Un *offset* (décalage) définit le nombre de jours d'attente après le jour prévu pour exécuter une association. Par exemple, si vous avez spécifié une planification cron de `cron(0 0 ? * THU#2 *)`, vous pouvez spécifier le numéro 3 dans le champ **Schedule offset** (Décalage de planification) pour exécuter l'association tous les dimanches après le deuxième jeudi du mois.

Pour utiliser des décalages, vous devez choisir le **Apply association only at the next specified Cron interval** (Appliquer l'association uniquement à l'intervalle Cron spécifié suivant) dans la console ou vous devez spécifier l'utilisation du paramètre `--apply-only-at-cron-interval` à partir de la ligne de commande. Cette option indique à State Manager ne pas exécuter d'association immédiatement après sa création.

Le tableau suivant présente des exemples d'expressions cron pour les associations.


**Exemples cron pour associations**  

| Exemple | Détails | 
| --- | --- | 
|  cron(0/30 \$1 \$1 \$1 ? \$1)  |  Toutes les 30 minutes  | 
|  cron(0 0/1 \$1 \$1 ? \$1)  |  Toutes les heures  | 
|  cron(0 0/2 \$1 \$1 ? \$1)  |  Toutes les 2 heures  | 
|  cron(0 0/4 \$1 \$1 ? \$1)  |  Toutes les 4 heures  | 
|  cron(0 0/8 \$1 \$1 ? \$1)  |  Toutes les 8 heures  | 
|  cron(0 0/12 \$1 \$1 ? \$1)  |  Toutes les 12 heures  | 
|  cron(15 13 ? \$1 \$1 \$1)  |  Tous les jours à 13 h 15  | 
|  cron(15 13 ? \$1 MON \$1)  |  Tous les lundis à 13 h 15  | 
|  cron(30 23 ? \$1 TUE\$13 \$1)  |  Le troisième mardi de chaque mois à 23 h 30  | 

Voici quelques exemples d'expressions rate pour les associations.


**Exemples rate pour les associations**  

| Exemple | Détails | 
| --- | --- | 
|  rate(30 minutes)  |  Toutes les 30 minutes  | 
|  rate(1 hour)  |  Toutes les heures  | 
|  rate(5 hours)  |  Toutes les 5 heures  | 
|  rate(15 days)  |  Tous les 15 jours  | 

****AWS CLI exemples pour les associations****  
Pour créer des State Manager associations à l'aide de AWS CLI, vous devez inclure le `--schedule-expression` paramètre dans une expression cron ou rate. Les exemples suivants utilisent le AWS CLI sur une machine Linux locale.

**Note**  
Par défaut, lorsque vous créez une nouvelle association, le système l'exécute immédiatement après sa création, puis selon la planification que vous avez spécifiée. Spécifiez `--apply-only-at-cron-interval` de sorte que l'association ne s'exécute pas immédiatement après sa création. Ce paramètre n'est pas pris en charge pour les expressions rate.

```
aws ssm create-association \
    --association-name "My-Cron-Association" \
    --schedule-expression "cron(0 2 ? * SUN *)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent
```

```
aws ssm create-association \
    --association-name "My-Rate-Association" \
    --schedule-expression "rate(7 days)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent
```

```
aws ssm create-association \
    --association-name "My-Rate-Association" \
    --schedule-expression "at(2020-07-07T15:55:00)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent \
    --apply-only-at-cron-interval
```

## Expressions cron et rate pour les fenêtres de maintenance
<a name="reference-cron-and-rate-expressions-maintenance-window"></a>

Cette section inclut des exemples d'expressions cron et rate pour les fenêtres de maintenance.

Contrairement aux associations State Manager, les fenêtres de maintenance prennent en charge toutes les expressions cron et rate. Cela inclut la prise en charge des valeurs dans le champ secondes.

Par exemple, l'expression cron à 6 champs exécute une fenêtre de maintenance à 9 h 30 chaque jour.

```
cron(30 09 ? * * *)
```

Si l'on ajoute une valeur au champ `Seconds`, l'expression cron suivante à 7 champs exécute une fenêtre de maintenance tous les jours à 9 h 30 et 24 s.

```
cron(24 30 09 ? * * *)
```

Le tableau suivant fournit des exemples supplémentaires d'expressions cron à 6 champs pour les fenêtres de maintenance.


**Exemples cron pour les fenêtres de maintenance**  

| Exemple | Détails | 
| --- | --- | 
|  cron(0 2 ? \$1 THU\$13 \$1)  |  2 h 00 le troisième jeudi de chaque mois  | 
|  cron(15 10 ? \$1 \$1 \$1)  |  10 h 15 tous les jours  | 
|  cron(15 10 ? \$1 MON-FRI \$1)  |  10 h 15 chaque lundi, mardi, mercredi, jeudi et vendredi  | 
|  cron(0 2 L \$1 ? \$1)  |  2 h 00 le dernier jour de chaque mois  | 
|  cron(15 10 ? \$1 6L \$1)  |  10 h 15 le dernier vendredi de chaque mois  | 

Le tableau suivant fournit des exemples rate pour les fenêtres de maintenance.


**Exemples rate pour les fenêtres de maintenance**  

| Exemple | Détails | 
| --- | --- | 
|  rate(30 minutes)  |  Toutes les 30 minutes  | 
|  rate(1 hour)  |  Toutes les heures  | 
|  rate(5 hours)  |  Toutes les 5 heures  | 
|  rate(25 days)  |  Tous les 25 jours  | 

****AWS CLI exemples de fenêtres de maintenance****  
Pour créer des fenêtres de maintenance à l'aide de AWS CLI, vous devez inclure le `--schedule` paramètre dans une expression cron ou rate ou un horodatage. Les exemples suivants utilisent le AWS CLI sur une machine Linux locale. 

```
aws ssm create-maintenance-window \
    --name "My-Cron-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "cron(0 16 ? * TUE *)" \
    --schedule-timezone "America/Los_Angeles" \
    --start-date 2021-01-01T00:00:00-08:00 \
    --end-date 2021-06-30T00:00:00-08:00 \
    --duration 4 \
    --cutoff 1
```

```
aws ssm create-maintenance-window \
    --name "My-Rate-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "rate(7 days)" \
    --duration 4 \
    --schedule-timezone "America/Los_Angeles" \
    --cutoff 1
```

```
aws ssm create-maintenance-window \
    --name "My-TimeStamp-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "at(2021-07-07T13:15:30)" \
    --duration 4 \
    --schedule-timezone "America/Los_Angeles" \
    --cutoff 1
```

**Plus d'informations**  
[Expression CRON](https://en.wikipedia.org/wiki/Cron#CRON_expression) sur le *site web Wikipedia*