

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.

# Exemples de création et de gestion de piscines chaudes à l'aide du AWS CLI
<a name="examples-warm-pools-aws-cli"></a>

Vous pouvez créer et gérer des piscines chaudes à l'aide du AWS Management Console, AWS Command Line Interface (AWS CLI) ou SDKs.

Les exemples suivants vous montrent comment créer et gérer des groupes d'instances pré-initialisées à l'aide de la AWS CLI.

**Topics**
+ [Exemple 1 : conserver des instances dans l'état `Stopped`](#warm-pool-configuration-ex1)
+ [Exemple 2 : conserver des instances dans l'état `Running`](#warm-pool-configuration-ex2)
+ [Exemple 3 : conserver des instances dans l'état `Hibernated`](#warm-pool-configuration-ex3)
+ [Exemple 4 : renvoyer des instances au groupe d'instances pré-initialisées lors de la mise à l'échelle horizontale](#warm-pool-configuration-ex4)
+ [Exemple 5 : spécifier le nombre minimal d'instances dans le groupe d'instances pré-initialisées](#warm-pool-configuration-ex5)
+ [Exemple 6 : définir la taille de la piscine chaude à l'aide d'une spécification personnalisée](#warm-pool-configuration-ex6)
+ [Exemple 7 : définir une taille absolue de groupe d'instances pré-initialisées](#warm-pool-configuration-ex7)
+ [Exemple 8 : supprimer un groupe d'instances pré-initialisées](#delete-warm-pool-cli)

## Exemple 1 : conserver des instances dans l'état `Stopped`
<a name="warm-pool-configuration-ex1"></a>

L'[put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemple suivant crée un pool de chaleur qui maintient les instances dans un `Stopped` état.

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped
```

## Exemple 2 : conserver des instances dans l'état `Running`
<a name="warm-pool-configuration-ex2"></a>

L'[put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemple suivant crée un pool de chaleur qui maintient les instances dans un `Running` état plutôt que dans un `Stopped` état. 

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Running
```

## Exemple 3 : conserver des instances dans l'état `Hibernated`
<a name="warm-pool-configuration-ex3"></a>

L'[put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemple suivant crée un pool de chaleur qui maintient les instances dans un `Hibernated` état plutôt que dans un `Stopped` état. Cela vous permet d'arrêter les instances sans supprimer leur contenu en mémoire (RAM).

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Hibernated
```

## Exemple 4 : renvoyer des instances au groupe d'instances pré-initialisées lors de la mise à l'échelle horizontale
<a name="warm-pool-configuration-ex4"></a>

L'[put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemple suivant crée un pool de chaleur qui maintient les instances dans un `Stopped` état et inclut l'`--instance-reuse-policy`option. La valeur `'{"ReuseOnScaleIn": true}'` de la politique de réutilisation d'instance indique à Amazon EC2 Auto Scaling de renvoyer les instances vers le groupe d'instances pré-initialisées lors de la mise à l'échelle horizontale de votre groupe Auto Scaling.

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --instance-reuse-policy '{"ReuseOnScaleIn": true}'
```

## Exemple 5 : spécifier le nombre minimal d'instances dans le groupe d'instances pré-initialisées
<a name="warm-pool-configuration-ex5"></a>

L'[put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemple suivant crée un pool de chaleur qui gère un minimum de 4 instances, de sorte qu'au moins 4 instances soient disponibles pour gérer les pics de trafic. 

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --min-size 4
```

## Exemple 6 : définir la taille de la piscine chaude à l'aide d'une spécification personnalisée
<a name="warm-pool-configuration-ex6"></a>

Par défaut, Amazon EC2 Auto Scaling gère la taille de votre pool de chaleur comme la différence entre la capacité maximale et la capacité souhaitée du groupe Auto Scaling. Cependant, vous pouvez gérer la taille de la piscine chaude indépendamment de la capacité maximale du groupe en utilisant `--max-group-prepared-capacity` cette option.

L'[put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemple suivant crée un pool de chaleur et définit le nombre maximum d'instances pouvant exister simultanément dans le pool de chauffage et dans le groupe Auto Scaling. Si le groupe a une capacité souhaitée de 800 personnes, le pool de chaleur aura initialement une taille de 100 lorsqu'il s'initialisera après avoir exécuté cette commande. 

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --max-group-prepared-capacity 900
```

Pour conserver un nombre minimal d'instances dans le groupe, ajoutez l'option `--min-size` à la commande, comme suit. 

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --max-group-prepared-capacity 900 --min-size 25
```

## Exemple 7 : définir une taille absolue de groupe d'instances pré-initialisées
<a name="warm-pool-configuration-ex7"></a>

Si vous définissez les mêmes valeurs pour les options `--max-group-prepared-capacity` et `--min-size`, le groupe d'instances pré-initialisées a une taille absolue. L'[put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemple suivant crée un pool de chaleur qui maintient une taille de pool de chaleur constante de 10 instances.

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --min-size 10 --max-group-prepared-capacity 10
```

## Exemple 8 : supprimer un groupe d'instances pré-initialisées
<a name="delete-warm-pool-cli"></a>

Utilisez la [delete-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html)commande suivante pour supprimer un pool de chaleur. 

```
aws autoscaling delete-warm-pool --auto-scaling-group-name my-asg
```

S'il existe des instances dans le pool de chaleur, ou si des activités de dimensionnement sont en cours, utilisez la [delete-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html)commande avec l'`--force-delete`option. Cette option résilie également les instances Amazon EC2 et toutes les actions de cycle de vie en attente.

```
aws autoscaling delete-warm-pool --auto-scaling-group-name my-asg --force-delete
```