

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Exemplos para criar e gerenciar piscinas aquecidas com o AWS CLI
<a name="examples-warm-pools-aws-cli"></a>

Você pode criar e gerenciar piscinas aquecidas usando o Console de gerenciamento da AWS, AWS Command Line Interface (AWS CLI) ou SDKs.

Os exemplos a seguir mostram como criar e gerenciar pools ativos usando a AWS CLI.

**Topics**
+ [Exemplo 1: manter instâncias no estado `Stopped`](#warm-pool-configuration-ex1)
+ [Exemplo 2: manter instâncias no estado `Running`](#warm-pool-configuration-ex2)
+ [Exemplo 3: manter instâncias no estado `Hibernated`](#warm-pool-configuration-ex3)
+ [Exemplo 4: retornar instâncias para o pool ativo ao reduzir a escala na horizontal](#warm-pool-configuration-ex4)
+ [Exemplo 5: especificar o número mínimo de instâncias no pool ativo](#warm-pool-configuration-ex5)
+ [Exemplo 6: Definir o tamanho do grupo dinâmico usando uma especificação personalizada.](#warm-pool-configuration-ex6)
+ [Exemplo 7: definir um tamanho de pool ativo absoluto](#warm-pool-configuration-ex7)
+ [Exemplo 8: exclusão um pool ativo](#delete-warm-pool-cli)

## Exemplo 1: manter instâncias no estado `Stopped`
<a name="warm-pool-configuration-ex1"></a>

O [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemplo a seguir cria um pool aquecido que mantém as instâncias em um `Stopped` estado.

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

## Exemplo 2: manter instâncias no estado `Running`
<a name="warm-pool-configuration-ex2"></a>

O [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemplo a seguir cria um pool aquecido que mantém as instâncias em um `Running` estado em vez de em um `Stopped` estado. 

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

## Exemplo 3: manter instâncias no estado `Hibernated`
<a name="warm-pool-configuration-ex3"></a>

O [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemplo a seguir cria um pool aquecido que mantém as instâncias em um `Hibernated` estado em vez de em um `Stopped` estado. Isso permite interromper instâncias sem excluir o conteúdo da memória (RAM).

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

## Exemplo 4: retornar instâncias para o pool ativo ao reduzir a escala na horizontal
<a name="warm-pool-configuration-ex4"></a>

O [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemplo a seguir cria um pool aquecido que mantém as instâncias em um `Stopped` estado e inclui a `--instance-reuse-policy` opção. O valor da política de reutilização de instâncias `'{"ReuseOnScaleIn": true}'` informa ao Amazon EC2 Auto Scaling para devolver as instâncias ao pool ativo quando o grupo do Auto Scaling reduz a escala na horizontal.

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

## Exemplo 5: especificar o número mínimo de instâncias no pool ativo
<a name="warm-pool-configuration-ex5"></a>

O [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemplo a seguir cria um pool aquecido que mantém no mínimo 4 instâncias, para que haja pelo menos 4 instâncias disponíveis para lidar com picos de tráfego. 

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

## Exemplo 6: Definir o tamanho do grupo dinâmico usando uma especificação personalizada.
<a name="warm-pool-configuration-ex6"></a>

Por padrão, o Amazon EC2 Auto Scaling gerencia o tamanho do seu grupo dinâmico como a diferença entre a capacidade máxima e a desejada do grupo do Auto Scaling. No entanto, você pode gerenciar o tamanho do grupo dinâmico independentemente da sua capacidade máxima, usando a opção `--max-group-prepared-capacity`.

O [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemplo a seguir cria um pool aquecido e define o número máximo de instâncias que podem existir simultaneamente no pool aquecido e no grupo Auto Scaling. Se o grupo tiver uma capacidade desejada de 800, o grupo dinâmico terá inicialmente um tamanho de 100 ao ser inicializado após a execução desse comando. 

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

Para manter um número mínimo de instâncias no pool ativo, inclua a opção `--min-size` com o comando, da seguinte forma. 

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

## Exemplo 7: definir um tamanho de pool ativo absoluto
<a name="warm-pool-configuration-ex7"></a>

Se você definir os mesmos valores para as opções `--max-group-prepared-capacity` e `--min-size`, o pool ativo terá um tamanho absoluto. O [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html)exemplo a seguir cria um pool quente que mantém um tamanho constante de pool quente de 10 instâncias.

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

## Exemplo 8: exclusão um pool ativo
<a name="delete-warm-pool-cli"></a>

Use o [delete-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html)comando a seguir para excluir uma piscina aquecida. 

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

Se houver instâncias no pool aquecido ou se atividades de escalonamento estiverem em andamento, use o [delete-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html)comando com a `--force-delete` opção. Essa opção também terminará as instâncias do Amazon EC2 e quaisquer ações do ciclo de vida pendentes.

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