

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 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: Mantenha as instâncias no `estado` interrompido](#warm-pool-configuration-ex1)
+ [Exemplo 2: Mantenha as instâncias no `estado Em` execução](#warm-pool-configuration-ex2)
+ [Exemplo 3: Mantenha as instâncias no estado de `hibernação`](#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: Mantenha as instâncias no `estado` interrompido
<a name="warm-pool-configuration-ex1"></a>

Os seguintes exemplos de [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) criam um grupo de alta atividade que mantém as instâncias em um estado `Stopped`.

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

## Exemplo 2: Mantenha as instâncias no `estado Em` execução
<a name="warm-pool-configuration-ex2"></a>

Os seguintes exemplos de [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) criam um grupo de alta atividade que mantém as instâncias em um estado `Running` em vez de em um estado `Stopped`. 

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

## Exemplo 3: Mantenha as instâncias no estado de `hibernação`
<a name="warm-pool-configuration-ex3"></a>

Os seguintes exemplos de [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) criam um grupo de alta atividade que mantém as instâncias em um estado `Hibernated` em vez de em um estado `Stopped`. 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>

Os seguintes exemplos de [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) criam um pool ativo que mantém as instâncias em um estado `Stopped` e inclui a opção `--instance-reuse-policy`. 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>

Os seguintes exemplos de [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) criam um pool ativo que mantém um mínimo de 4 instâncias, de modo 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 exemplo [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) a seguir cria um grupo dinâmico e define o número máximo de instâncias que podem existir simultaneamente no grupo dinâmico e no grupo do 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 exemplo de [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) a seguir cria um pool ativo que mantém um tamanho de pool ativo constante 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 comando [delete-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html) para excluir um pool ativo. 

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

Se houver instâncias no pool ativo, ou se as atividades de dimensionamento estiverem em andamento, use o comando [delete-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html) com o a opção `--force-delete`. 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
```