

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.

# Créez des actions planifiées pour Application Auto Scaling à l'aide du AWS CLI
<a name="create-scheduled-actions"></a>

Les exemples suivants montrent comment créer des actions planifiées à l'aide de la AWS CLI [put-scheduled-action](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/put-scheduled-action.html)commande. Lorsque vous indiquez la nouvelle capacité, vous pouvez indiquer une capacité minimum, une capacité maximum ou les deux.

Ces exemples utilisent des cibles évolutives pour certains des services intégrés à Application Auto Scaling. Pour utiliser une autre cible évolutive, spécifiez son espace de noms dans`--service-namespace`, sa dimension évolutive dans `--scalable-dimension` et son ID de ressource dans`--resource-id`.

Lorsque vous utilisez le AWS CLI, n'oubliez pas que vos commandes s'exécutent dans la Région AWS configuration adaptée à votre profil. Si vous souhaitez exécuter les commandes dans une autre région, modifiez la région par défaut pour votre profil, ou utilisez le paramètre `--region` avec la commande.

**Topics**
+ [

## Créer une action planifiée qui ne se produit qu'une fois
](#one-time-schedule)
+ [

## Créer une action planifiée qui s'exécute à un intervalle récurrent
](#recurrence-schedule-rate)
+ [

## Créer une action planifiée qui s'exécute sur une planification récurrente
](#recurrence-schedule-cron)
+ [

## Créer une action planifiée unique qui spécifie un fuseau horaire
](#one-time-schedule-set-time-zone)
+ [

## Créer une action planifiée récurrente qui spécifie un fuseau horaire
](#recurring-schedule-set-time-zone)

## Créer une action planifiée qui ne se produit qu'une fois
<a name="one-time-schedule"></a>

Pour mettre à l'échelle automatiquement votre cible évolutive une seule fois, à une date et une heure spécifiées, utilisez l'option `--schedule "at(yyyy-mm-ddThh:mm:ss)"`.

**Example Exemple : pour effectuer une montée en puissance unique**  
Voici un exemple de création d'une action planifiée pour augmenter la capacité à une date et une heure spécifiques.   
À la date et à l'heure spécifiées pour `--schedule` (22 h 00 UTC le 31 mars 2021), si la valeur spécifiée pour `MinCapacity` est supérieure à la capacité actuelle, Application Auto Scaling augmente la capacité jusqu'à `MinCapacity`.  
**Linux, macOS ou Unix**  

```
aws application-autoscaling put-scheduled-action --service-namespace custom-resource \
  --scalable-dimension custom-resource:ResourceType:Property \
  --resource-id file://~/custom-resource-id.txt \
  --scheduled-action-name scale-out \
  --schedule "at(2021-03-31T22:00:00)" \
  --scalable-target-action MinCapacity=3
```
**Windows**  

```
aws application-autoscaling put-scheduled-action --service-namespace custom-resource ^
  --scalable-dimension custom-resource:ResourceType:Property ^
  --resource-id file://~/custom-resource-id.txt ^
  --scheduled-action-name scale-out ^
  --schedule "at(2021-03-31T22:00:00)" ^
  --scalable-target-action MinCapacity=3
```
Lorsque cette action planifiée est exécutée, si la capacité maximale est inférieure à la valeur spécifiée pour la capacité minimale, vous devez spécifier une nouvelle capacité minimale et maximale, et pas seulement la capacité minimale. 

**Example Exemple : pour effectuer une mise à l'échelle horizontale unique**  
Voici un exemple de création d'une action planifiée pour réduire la capacité à une date et une heure spécifiques.   
À la date et à l'heure spécifiées pour `--schedule` (22 h 30 UTC le 31 mars 2021), si la valeur spécifiée pour `MaxCapacity` est inférieure à la capacité actuelle, Application Auto Scaling réduit la capacité jusqu'à `MaxCapacity`.  
**Linux, macOS ou Unix**  

```
aws application-autoscaling put-scheduled-action --service-namespace custom-resource \
  --scalable-dimension custom-resource:ResourceType:Property \
  --resource-id file://~/custom-resource-id.txt \
  --scheduled-action-name scale-in \
  --schedule "at(2021-03-31T22:30:00)" \
  --scalable-target-action MinCapacity=0,MaxCapacity=0
```
**Windows**  

```
aws application-autoscaling put-scheduled-action --service-namespace custom-resource ^
  --scalable-dimension custom-resource:ResourceType:Property ^
  --resource-id file://~/custom-resource-id.txt ^
  --scheduled-action-name scale-in ^
  --schedule "at(2021-03-31T22:30:00)" ^
  --scalable-target-action MinCapacity=0,MaxCapacity=0
```

## Créer une action planifiée qui s'exécute à un intervalle récurrent
<a name="recurrence-schedule-rate"></a>

Pour planifier la mise à l'échelle à un intervalle récurrent, utilisez l'option `--schedule "rate(value unit)"`. La valeur doit être un nombre entier positif. L'unité peut être `minute`, `minutes`, `hour`, `hours`, `day` ou `days`. Pour plus d'informations, consultez la section [Expressions de taux](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html#eb-rate-expressions) dans le *guide de EventBridge l'utilisateur Amazon*.

Voici un exemple d'une action planifiée qui utilise une expression de fréquence. 

Selon la planification spécifiée (toutes les 5 heures à partir du 30 janvier 2021 à 12 h 00 UTC et jusqu'au 31 janvier 2021 à 22 h 00 UTC), si la valeur spécifiée pour `MinCapacity` est supérieure à la capacité actuelle, Application Auto Scaling augmente la capacité jusqu'à `MinCapacity`. Si la valeur spécifiée pour `MaxCapacity` est inférieure à la capacité actuelle, Application Auto Scaling réduit la capacité jusqu'à `MaxCapacity`. 

**Linux, macOS ou Unix**

```
aws application-autoscaling put-scheduled-action --service-namespace ecs \
  --scalable-dimension ecs:service:DesiredCount \
  --resource-id service/my-cluster/my-service \
  --scheduled-action-name my-recurring-action \
  --schedule "rate(5 hours)" \
  --start-time 2021-01-30T12:00:00 \
  --end-time 2021-01-31T22:00:00 \
  --scalable-target-action MinCapacity=3,MaxCapacity=10
```

**Windows**

```
aws application-autoscaling put-scheduled-action --service-namespace ecs ^
  --scalable-dimension ecs:service:DesiredCount ^
  --resource-id service/my-cluster/my-service ^
  --scheduled-action-name my-recurring-action ^
  --schedule "rate(5 hours)" ^
  --start-time 2021-01-30T12:00:00 ^
  --end-time 2021-01-31T22:00:00 ^
  --scalable-target-action MinCapacity=3,MaxCapacity=10
```

## Créer une action planifiée qui s'exécute sur une planification récurrente
<a name="recurrence-schedule-cron"></a>

Pour planifier la mise à l'échelle selon un calendrier récurrent, utilisez l'option `--schedule "cron(fields)"` Pour de plus amples informations, veuillez consulter [Planifiez des actions de dimensionnement récurrentes à l'aide d'Application Auto Scaling](scheduled-scaling-using-cron-expressions.md).

Voici un exemple d'une action planifiée qui utilise une expression cron. 

Selon la planification spécifiée (toutes les jours à 9 h 00 UTC), si la valeur spécifiée pour `MinCapacity` est supérieure à la capacité actuelle, Application Auto Scaling augmente la capacité jusqu'à `MinCapacity`. Si la valeur spécifiée pour `MaxCapacity` est inférieure à la capacité actuelle, Application Auto Scaling réduit la capacité jusqu'à `MaxCapacity`.

**Linux, macOS ou Unix**

```
aws application-autoscaling put-scheduled-action --service-namespace appstream \
  --scalable-dimension appstream:fleet:DesiredCapacity \
  --resource-id fleet/sample-fleet \
  --scheduled-action-name my-recurring-action \
  --schedule "cron(0 9 * * ? *)" \
  --scalable-target-action MinCapacity=10,MaxCapacity=50
```

**Windows**

```
aws application-autoscaling put-scheduled-action --service-namespace appstream ^
  --scalable-dimension appstream:fleet:DesiredCapacity ^
  --resource-id fleet/sample-fleet ^
  --scheduled-action-name my-recurring-action ^
  --schedule "cron(0 9 * * ? *)" ^
  --scalable-target-action MinCapacity=10,MaxCapacity=50
```

## Créer une action planifiée unique qui spécifie un fuseau horaire
<a name="one-time-schedule-set-time-zone"></a>

Les actions planifiées sont définies par défaut sur le fuseau horaire UTC. Pour spécifier un fuseau horaire différent, incluez l'option `--timezone` et spécifiez le nom canonique du fuseau horaire (`America/New_York`, par exemple). Pour plus d'informations, consultez [https://www.joda.org/joda-time/timezones.html](https://www.joda.org/joda-time/timezones.html), qui fournit des informations sur les fuseaux horaires IANA pris en charge lors des appels [put-scheduled-action](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/put-scheduled-action.html).

Voici un exemple qui utilise l'option `--timezone` lors de la création d'une action planifiée pour mettre à l'échelle la capacité à une date et une heure spécifiques. 

À la date et à l'heure spécifiées pour `--schedule` (17 h, heure locale, le 31 janvier 2021), si la valeur spécifiée pour `MinCapacity` est supérieure à la capacité actuelle, Application Auto Scaling augmente la capacité jusqu'à `MinCapacity`. Si la valeur spécifiée pour `MaxCapacity` est inférieure à la capacité actuelle, Application Auto Scaling réduit la capacité jusqu'à `MaxCapacity`.

**Linux, macOS ou Unix**

```
aws application-autoscaling put-scheduled-action --service-namespace comprehend \
  --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
  --resource-id arn:aws:comprehend:us-west-2:123456789012:document-classifier-endpoint/EXAMPLE \
  --scheduled-action-name  my-one-time-action \
  --schedule "at(2021-01-31T17:00:00)" --timezone "America/New_York" \
  --scalable-target-action MinCapacity=1,MaxCapacity=3
```

**Windows**

```
aws application-autoscaling put-scheduled-action --service-namespace comprehend ^
  --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits ^
  --resource-id arn:aws:comprehend:us-west-2:123456789012:document-classifier-endpoint/EXAMPLE ^
  --scheduled-action-name  my-one-time-action ^
  --schedule "at(2021-01-31T17:00:00)" --timezone "America/New_York" ^
  --scalable-target-action MinCapacity=1,MaxCapacity=3
```

## Créer une action planifiée récurrente qui spécifie un fuseau horaire
<a name="recurring-schedule-set-time-zone"></a>

Voici un exemple qui utilise l'option `--timezone` lors de la création d'une action planifiée récurrente pour mettre à l'échelle la capacité. Pour de plus amples informations, veuillez consulter [Planifiez des actions de dimensionnement récurrentes à l'aide d'Application Auto Scaling](scheduled-scaling-using-cron-expressions.md).

Selon la planification spécifiée (du lundi au vendredi à 18 h 00, heure locale), si la valeur spécifiée pour `MinCapacity` est supérieure à la capacité actuelle, Application Auto Scaling augmente la capacité jusqu'à `MinCapacity`. Si la valeur spécifiée pour `MaxCapacity` est inférieure à la capacité actuelle, Application Auto Scaling réduit la capacité jusqu'à `MaxCapacity`.

**Linux, macOS ou Unix**

```
aws application-autoscaling put-scheduled-action --service-namespace lambda \
  --scalable-dimension lambda:function:ProvisionedConcurrency \
  --resource-id function:my-function:BLUE \
  --scheduled-action-name my-recurring-action \
  --schedule "cron(0 18 ? * MON-FRI *)" --timezone "Etc/GMT+9" \
  --scalable-target-action MinCapacity=10,MaxCapacity=50
```

**Windows**

```
aws application-autoscaling put-scheduled-action --service-namespace lambda ^
  --scalable-dimension lambda:function:ProvisionedConcurrency ^
  --resource-id function:my-function:BLUE ^
  --scheduled-action-name my-recurring-action ^
  --schedule "cron(0 18 ? * MON-FRI *)" --timezone "Etc/GMT+9" ^
  --scalable-target-action MinCapacity=10,MaxCapacity=50
```