

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á.

# Suspender e retomar a escalabilidade do Application Auto Scaling
<a name="application-auto-scaling-suspend-resume-scaling"></a>

Este tópico explica como suspender e retomar uma ou mais das ações de dimensionamento para os destinos dimensionáveis no aplicativo. O recurso de suspender e retomar é usado para pausar temporariamente as atividades de dimensionamento acionadas pelas políticas de dimensionamento e pelas ações programadas. Isso pode ser útil, por exemplo, quando você quer eliminar a possibilidade de o dimensionamento automático interferir enquanto você está fazendo uma alteração ou investigando um problema de configuração. As políticas de dimensionamento e as ações programadas podem ser mantidas e, quando você estiver pronto, as ações de dimensionamento poderão ser reiniciadas.

O exemplo de comandos da CLI a seguir, é necessário passar os parâmetros formatados em JSON em um arquivo config.json. Você também pode passar esses parâmetros na linha de comando usando aspas para incluir a estrutura de dados JSON. Para obter mais informações, consulte [Usar aspas com strings na AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) no *Manual do usuário da AWS Command Line Interface *.

**Topics**
+ [Atividades de escalabilidade](#process-types)
+ [Suspender e retomar atividades de escalabilidade](#aas-suspend-aws-cli)

**nota**  
Para conferir instruções sobre como suspender os processos de aumento horizontal da escala enquanto as implantações do Amazon ECS estiverem em andamento, consulte a documentação a seguir:  
[Escalabilidade automática e implantações do serviço](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-auto-scaling.html#service-auto-scaling-deployments) no *Guia do desenvolvedor do Amazon Elastic Container Service*

## Atividades de escalabilidade
<a name="process-types"></a>

O Application Auto Scaling oferece suporte para que as atividades de escalabilidade a seguir sejam colocadas em um estado suspenso:
+ Todas as atividades de redução que são acionadas por uma política de dimensionamento.
+ Todas as atividades de expansão que são acionados por uma política de dimensionamento.
+ Todas as ações de dimensionamento que envolvem ações programadas. 

As descrições a seguir explicam o que acontece quando as ações de dimensionamento individuais são suspensas. Cada uma pode ser suspensa e retomada de forma independente. Dependendo do motivo da suspensão de uma ação de dimensionamento, pode ser necessário suspender várias ações de dimensionamento em conjunto. 

`DynamicScalingInSuspended`
+ O Application Auto Scaling não remove a capacidade quando uma política de dimensionamento do monitoramento do objetivo ou uma política de escalabilidade de etapa é acionada. Isso permite que você desabilite temporariamente atividades de redução associadas a políticas de dimensionamento sem excluir as políticas de dimensionamento ou seus alarmes do CloudWatch associados. Quando você retomar a redução, o Application Auto Scaling avalia políticas com limites de alarme que estão atualmente em falha.

`DynamicScalingOutSuspended`
+ O Application Auto Scaling não remove a capacidade quando uma política de dimensionamento com monitoramento do objetivo ou uma política de escalabilidade de etapa é acionada. Isso permite que você desabilite temporariamente atividades de ampliação associadas a políticas de dimensionamento sem excluir as políticas de dimensionamento ou seus alarmes do CloudWatch associados. Quando você retomar o aumento da escala, o Application Auto Scaling avalia políticas com limites de alarme que estão atualmente em falha.

`ScheduledScalingSuspended`
+ O Application Auto Scaling não inicia as ações de escalabilidade programadas para execução durante o período de suspensão. Quando você retomar a escalabilidade programada, o Application Auto Scaling somente avaliará as ações programadas cujo tempo de execução ainda não tenha passado.

## Suspender e retomar atividades de escalabilidade
<a name="aas-suspend-aws-cli"></a>

Você pode suspender e retomar atividades de escalabilidade individuais ou todas as atividades de escalabilidade para o destino de escalabilidade do Application Auto Scaling.

**nota**  
Em resumo, esses exemplos ilustram como suspender e retomar a escalabilidade para uma tabela do DynamoDB. Para especificar um destino escalável diferente, especifique o namespace em `--service-namespace`, sua dimensão escalável em `--scalable-dimension`, e o ID do recurso em `--resource-id`. Para obter mais informações e exemplos de cada serviço, consulte os tópicos na [Serviços da AWS que você pode usar com o Application Auto Scaling](integrated-services-list.md).

**Para suspender uma atividade de dimensionamento**  
Abra uma janela da linha de comando e use o comando [register-scalable-target](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/register-scalable-target.html) com a opção `--suspended-state` da maneira indicada a seguir. 

**Linux, macOS ou Unix**

```
aws application-autoscaling register-scalable-target --service-namespace dynamodb \
  --scalable-dimension dynamodb:table:ReadCapacityUnits --resource-id table/my-table \
  --suspended-state file://config.json
```

**Windows**

```
aws application-autoscaling register-scalable-target --service-namespace dynamodb --scalable-dimension dynamodb:table:ReadCapacityUnits --resource-id table/my-table --suspended-state file://config.json
```

Se obtiver êxito, esse comando retornará o ARN do destino escalável.

```
{
    "ScalableTargetARN": "arn:aws:application-autoscaling:region:account-id:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}
```

Para suspender somente atividades de redução que são acionadas por uma política de dimensionamento, especifique o seguinte no config.json.

```
{
    "DynamicScalingInSuspended":true
}
```

Para suspender somente atividades de ampliação que são acionadas por uma política de dimensionamento, especifique o seguinte no config.json.

```
{
    "DynamicScalingOutSuspended":true
}
```

Para suspender somente atividades de dimensionamento que envolvem ações programadas, especifique o seguinte no config.json.

```
{
    "ScheduledScalingSuspended":true
}
```

**Para suspender todas as atividades de dimensionamento**  
Use o comando [register-scalable-target](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/register-scalable-target.html) com a opção `--suspended-state` da seguinte forma.

**Linux, macOS ou Unix**

```
aws application-autoscaling register-scalable-target --service-namespace dynamodb \
  --scalable-dimension dynamodb:table:ReadCapacityUnits --resource-id table/my-table \
  --suspended-state file://config.json
```

**Windows**

```
aws application-autoscaling register-scalable-target --service-namespace dynamodb --scalable-dimension dynamodb:table:ReadCapacityUnits --resource-id table/my-table --suspended-state file://config.json
```

Este exemplo pressupõe que o arquivo config.json contém os parâmetros formatados em JSON a seguir. 

```
{
    "DynamicScalingInSuspended":true,
    "DynamicScalingOutSuspended":true,
    "ScheduledScalingSuspended":true
}
```

Se obtiver êxito, esse comando retornará o ARN do destino escalável.

```
{
    "ScalableTargetARN": "arn:aws:application-autoscaling:region:account-id:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}
```

### Visualizar atividades de escalabilidade suspensas
<a name="aas-check-suspend-state-aws-cli"></a>

Use o comando [describe-scalable-targets](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/describe-scalable-targets.html) para determinar quais ações de escalabilidade estão em um estado suspenso para um destino dimensionável.

**Linux, macOS ou Unix**

```
aws application-autoscaling describe-scalable-targets --service-namespace dynamodb \
  --scalable-dimension dynamodb:table:ReadCapacityUnits --resource-id table/my-table
```

**Windows**

```
aws application-autoscaling describe-scalable-targets --service-namespace dynamodb --scalable-dimension dynamodb:table:ReadCapacityUnits --resource-id table/my-table
```

O seguinte é um exemplo de saída.

```
{
    "ScalableTargets": [
        {
            "ServiceNamespace": "dynamodb",
            "ScalableDimension": "dynamodb:table:ReadCapacityUnits",
            "ResourceId": "table/my-table",
            "MinCapacity": 1,
            "MaxCapacity": 20,
            "SuspendedState": {
                "DynamicScalingOutSuspended": true,
                "DynamicScalingInSuspended": true,
                "ScheduledScalingSuspended": true
            },
            "CreationTime": 1558125758.957,
            "RoleARN": "arn:aws:iam::123456789012:role/aws-service-role/dynamodb.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_DynamoDBTable"
        }
    ]
}
```

### Retomar atividades de escalabilidade
<a name="aas-resume-aws-cli"></a>

Quando estiver pronto para retomar a atividade de dimensionamento, você poderá retomá-la usando o comando [register-scalable-target](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/register-scalable-target.html).

O exemplo de comando a seguir retoma todas as atividades de dimensionamento para o destino dimensionável especificado. 

**Linux, macOS ou Unix**

```
aws application-autoscaling register-scalable-target --service-namespace dynamodb \
  --scalable-dimension dynamodb:table:ReadCapacityUnits --resource-id table/my-table \
  --suspended-state file://config.json
```

**Windows**

```
aws application-autoscaling register-scalable-target --service-namespace dynamodb --scalable-dimension dynamodb:table:ReadCapacityUnits --resource-id table/my-table --suspended-state file://config.json
```

Este exemplo pressupõe que o arquivo config.json contém os parâmetros formatados em JSON a seguir. 

```
{
    "DynamicScalingInSuspended":false,
    "DynamicScalingOutSuspended":false,
    "ScheduledScalingSuspended":false
}
```

Se obtiver êxito, esse comando retornará o ARN do destino escalável.

```
{
    "ScalableTargetARN": "arn:aws:application-autoscaling:region:account-id:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}
```