

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

# Migre seu plano de escalabilidade
<a name="migrate-scaling-plan"></a>

Você pode migrar de um plano de escalabilidade para as políticas de escalabilidade Amazon EC2 Auto Scaling e Application Auto Scaling.

**Topics**
+ [Etapa 1: revisar sua configuração existente](#review-your-existing-setup)
+ [Etapa 2: criar políticas de escalabilidade preditiva](#migrate-predictive-scaling-configurations)
+ [Etapa 3: Analise as previsões geradas pelas políticas de escalabilidade preditiva](#review-predictive-scaling-policy-forecast)
+ [Etapa 4: Prepare-se para excluir o plano de escalabilidade](#prepare-to-delete-the-scaling-plan)
+ [Etapa 5: excluir o plano de escalabilidade](#delete-scaling-plan)
+ [Etapa 6: reativar o escalonamento dinâmico](#create-target-tracking-scaling-policies)
+ [Etapa 7: reativar a escala preditiva](#switch-predictive-scaling-to-forecast-and-scale)
+ [Referência do Amazon EC2 Auto Scaling para migrar políticas de escalabilidade de rastreamento de metas](#target-tracking-mapping-reference-ec2-auto-scaling)
+ [Referência do Application Auto Scaling para migrar políticas de escalabilidade de rastreamento de metas](#target-tracking-mapping-reference-application-auto-scaling)
+ [Mais informações](#migrate-scaling-plan-more-info)

**Importante**  
Para migrar um plano de escalabilidade, você deve concluir várias etapas na ordem exata. Ao migrar seu plano de escalabilidade, *não o atualize, pois isso* interrompe a ordem das operações e pode causar comportamentos indesejáveis.

## Etapa 1: revisar sua configuração existente
<a name="review-your-existing-setup"></a>

Para determinar quais configurações de escala você deve mover, use o [describe-scaling-plans](https://docs.aws.amazon.com/cli/latest/reference/autoscaling-plans/describe-scaling-plans.html)comando. 

```
aws autoscaling-plans describe-scaling-plans \
  --scaling-plan-names my-scaling-plan
```

Anote os itens que você deseja preservar do plano de escalabilidade existente, que pode incluir o seguinte:
+ **`MinCapacity`**— A capacidade mínima do recurso escalável.
+ **`MaxCapacity`**— A capacidade máxima do recurso escalável.
+ **`PredefinedLoadMetricType`**— Uma métrica de carga para escalabilidade preditiva.
+ **`PredefinedScalingMetricType`**— Uma métrica de escalabilidade para rastreamento de metas, escalabilidade (dinâmica) e escala preditiva.
+ **`TargetValue`**— O valor alvo para a métrica de escala.

### Diferenças entre planos de escalabilidade e políticas de escalabilidade
<a name="differences"></a>

Há algumas diferenças importantes entre planos de escalabilidade e políticas de escalabilidade:
+ Uma política de escalabilidade pode permitir somente um tipo de escalabilidade: escalabilidade de rastreamento de metas ou escalabilidade preditiva. Para usar os dois métodos de escalabilidade, você deve criar políticas separadas.
+ Da mesma forma, você deve definir a métrica de escalabilidade para escalabilidade preditiva e a métrica de escala para escalabilidade de rastreamento de metas separadamente dentro de suas respectivas políticas.

## Etapa 2: criar políticas de escalabilidade preditiva
<a name="migrate-predictive-scaling-configurations"></a>

Se você não usa escalabilidade preditiva, vá em frente para. [Etapa 4: Prepare-se para excluir o plano de escalabilidade](#prepare-to-delete-the-scaling-plan)

Para fornecer tempo para avaliar a previsão, recomendamos que você crie políticas de escalabilidade preditiva antes de outras políticas de escalabilidade.

Para qualquer grupo de Auto Scaling com uma especificação de métrica de carga existente, faça o seguinte para transformá-la em uma política de escalabilidade preditiva baseada no Amazon EC2 Auto Scaling.

**Para criar políticas de escalabilidade preditiva**

1. Em um arquivo JSON, defina uma `MetricSpecifications` estrutura conforme mostrado no exemplo a seguir:

   ```
   {
     "MetricSpecifications":[
       {
         ... 
       }
     ]
   }
   ```

1. Na `MetricSpecifications` estrutura, para cada métrica de carga em seu plano de escalabilidade, crie uma `PredefinedLoadMetricSpecification` ou `CustomizedLoadMetricSpecification` use as configurações equivalentes do plano de escalabilidade.

   A seguir estão exemplos da estrutura da seção métrica de carga.

------
#### [ With predefined metrics ]

   ```
   {
     "MetricSpecifications":[
       {
         "PredefinedLoadMetricSpecification":{
           "PredefinedMetricType":"ASGTotalCPUUtilization"
         },
         ...
       }
     ]
   }
   ```

   Para obter mais informações, consulte a [PredictiveScalingPredefinedLoadMetric](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingPredefinedLoadMetric.html)Referência da API *Amazon EC2 Auto Scaling*.

------
#### [ With custom metrics ]

   ```
   {
     "MetricSpecifications":[
       {
         "CustomizedLoadMetricSpecification":{
           "MetricDataQueries":[
             {
               "Id":"load_metric",
               "MetricStat":{
                 "Metric":{
                   "MetricName":"MyLoadMetric",
                   "Namespace":"MyNameSpace",
                   "Dimensions":[
                     {
                       "Name":"MyOptionalMetricDimensionName",
                       "Value":"MyOptionalMetricDimensionValue"
                     }
                   ]
                 },
                 "Stat":"Sum"
               }
             }
           ]
         },
         ...
       }
     ]
   }
   ```

   Para obter mais informações, consulte a [PredictiveScalingCustomizedLoadMetric](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingCustomizedLoadMetric.html)Referência da API *Amazon EC2 Auto Scaling*.

------

1. Adicione a especificação métrica de escala ao `MetricSpecifications` e defina um valor alvo.

   A seguir estão exemplos da estrutura das seções de métrica de escala e valor alvo.

------
#### [ With predefined metrics ]

   ```
   {
     "MetricSpecifications":[
       {
         "PredefinedLoadMetricSpecification":{
           "PredefinedMetricType":"ASGTotalCPUUtilization"
         },
         "PredefinedScalingMetricSpecification":{
           "PredefinedMetricType":"ASGCPUUtilization"
         },
         "TargetValue":50
       }
     ],
     ...
   }
   ```

   Para obter mais informações, consulte a [PredictiveScalingPredefinedScalingMetric](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingPredefinedScalingMetric.html)Referência da API *Amazon EC2 Auto Scaling*.

------
#### [ With custom metrics ]

   ```
   {
     "MetricSpecifications":[
       {
         "CustomizedLoadMetricSpecification":{
           "MetricDataQueries":[
             {
               "Id":"load_metric",
               "MetricStat":{
                 "Metric":{
                   "MetricName":"MyLoadMetric",
                   "Namespace":"MyNameSpace",
                   "Dimensions":[
                     {
                       "Name":"MyOptionalMetricDimensionName",
                       "Value":"MyOptionalMetricDimensionValue"
                     }
                   ]
                 },
                 "Stat":"Sum"
               }
             }
           ]
         },
         "CustomizedScalingMetricSpecification":{
           "MetricDataQueries":[
             {
               "Id":"scaling_metric",
               "MetricStat":{
                 "Metric":{
                   "MetricName":"MyUtilizationMetric",
                   "Namespace":"MyNameSpace",
                   "Dimensions":[
                     {
                       "Name":"MyOptionalMetricDimensionName",
                       "Value":"MyOptionalMetricDimensionValue"
                     }
                   ]
                 },
                 "Stat":"Average"
               }
             }
           ]
         },
         "TargetValue":50
       }
     ],
     ...
   }
   ```

   Para obter mais informações, consulte a [PredictiveScalingCustomizedScalingMetric](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingCustomizedScalingMetric.html)Referência da API *Amazon EC2 Auto Scaling*.

------

1. Para fazer apenas uma previsão, adicione a propriedade `Mode` com um valor de`ForecastOnly`. Depois de concluir a migração da escala preditiva e garantir que a previsão seja precisa e confiável, você pode alterar o modo para permitir a escalabilidade. Para obter mais informações, consulte [Etapa 7: reativar a escala preditiva](#switch-predictive-scaling-to-forecast-and-scale). 

   ```
   {
     "MetricSpecifications":[
     ...
     ],
     "Mode":"ForecastOnly",
     ...
   }
   ```

   Para obter mais informações, consulte a [PredictiveScalingConfiguration](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingConfiguration.html)Referência da API *Amazon EC2 Auto Scaling*.

1. Se a `ScheduledActionBufferTime` propriedade estiver presente em seu plano de escalabilidade, copie seu valor para a `SchedulingBufferTime` propriedade em sua política de escalabilidade preditiva.

   ```
   {
     "MetricSpecifications":[
     ...
     ],
     "Mode":"ForecastOnly",
     "SchedulingBufferTime":300,
     ...
   }
   ```

   Para obter mais informações, consulte a [PredictiveScalingConfiguration](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingConfiguration.html)Referência da API *Amazon EC2 Auto Scaling*.

1. Se as `PredictiveScalingMaxCapacityBuffer` propriedades `PredictiveScalingMaxCapacityBehavior` e estiverem presentes em seu plano de escalabilidade, você poderá configurar as `MaxCapacityBuffer` propriedades `MaxCapacityBreachBehavior` e em sua política de escalabilidade preditiva. Essas propriedades definem o que deve acontecer se a capacidade prevista se aproximar ou exceder a capacidade máxima especificada para o grupo Auto Scaling.
**Atenção**  
Se você definir a `MaxCapacityBreachBehavior` propriedade como`IncreaseMaxCapacity`, mais instâncias poderão ser iniciadas do que o pretendido, a menos que você monitore e gerencie o aumento da capacidade máxima. A capacidade máxima aumentada se torna a nova capacidade máxima normal para o grupo Auto Scaling até que você a atualize manualmente. A capacidade máxima não diminui automaticamente de volta ao máximo original.

   ```
   {
     "MetricSpecifications":[
     ...
     ],
     "Mode":"ForecastOnly",
     "SchedulingBufferTime":300,
     "MaxCapacityBreachBehavior": "IncreaseMaxCapacity",
     "MaxCapacityBuffer": 10
   }
   ```

   Para obter mais informações, consulte a [PredictiveScalingConfiguration](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredictiveScalingConfiguration.html)Referência da API *Amazon EC2 Auto Scaling*.

1. Salve o arquivo JSON com um nome exclusivo. Anote o nome do arquivo. Você precisará dela na próxima etapa e novamente no final do procedimento de migração ao reativar suas políticas de escalabilidade preditiva. Para obter mais informações, consulte [Etapa 7: reativar a escala preditiva](#switch-predictive-scaling-to-forecast-and-scale). 

1. Depois de salvar o arquivo JSON, execute o [put-scaling-policy](https://docs.aws.amazon.com/cli/latest/reference/autoscaling/put-scaling-policy.html)comando. No exemplo a seguir, substitua cada *user input placeholder* por suas próprias informações.

   ```
   aws autoscaling put-scaling-policy --policy-name my-predictive-scaling-policy \
     --auto-scaling-group-name my-asg --policy-type PredictiveScaling \
     --predictive-scaling-configuration file://my-predictive-scaling-config.json
   ```

   Se bem-sucedido, esse comando gerará o nome do recurso da Amazon (ARN) da política.

   ```
   {
     "PolicyARN": "arn:aws:autoscaling:region:account-id:scalingPolicy:2f4f5048-d8a8-4d14-b13a-d1905620f345:autoScalingGroupName/my-asg:policyName/my-predictive-scaling-policy",
     "Alarms": []
   }
   ```

1. Repita essas etapas para cada especificação de métrica de carga que você está migrando para uma política de escalabilidade preditiva baseada no Amazon EC2 Auto Scaling.

## Etapa 3: Analise as previsões geradas pelas políticas de escalabilidade preditiva
<a name="review-predictive-scaling-policy-forecast"></a>

Se você não usa a escala preditiva, pule o procedimento a seguir.

Uma previsão está disponível logo após você criar uma política de escalabilidade preditiva. Depois que o Amazon EC2 Auto Scaling gerar a previsão, você poderá revisar a previsão da política por meio do console do Amazon EC2 Auto Scaling e ajustá-la conforme necessário.

**Para revisar a previsão de uma política de escalabilidade preditiva**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, escolha Grupos de **Auto Scaling** e, em seguida, escolha o nome do seu grupo de Auto Scaling na lista.

1. Na guia **Escalabilidade automática**, em Políticas de **escalabilidade preditiva, escolha sua política**.

1. Na seção **Monitorar**, você pode visualizar as previsões passadas e futuras de carga e de capacidade da política em relação aos valores reais.

   Para obter mais informações, consulte [Analise os gráficos de monitoramento de escalabilidade preditiva no Guia do usuário](https://docs.aws.amazon.com/autoscaling/ec2/userguide/predictive-scaling-graphs.html#review-predictive-scaling-monitoring-graphs) do *Amazon EC2 Auto Scaling*.

1. Repita essas etapas para cada política de escalabilidade preditiva que você criou.

## Etapa 4: Prepare-se para excluir o plano de escalabilidade
<a name="prepare-to-delete-the-scaling-plan"></a>

Para quaisquer recursos com uma configuração de escalabilidade de rastreamento de metas existente, faça o seguinte para coletar todas as informações adicionais necessárias do plano de escalabilidade antes de excluí-lo.

Para descrever as informações da política de escalabilidade do plano de escalabilidade, use o [describe-scaling-plan-resources](https://docs.aws.amazon.com/cli/latest/reference/autoscaling-plans/describe-scaling-plan-resources.html)comando. No exemplo de comando a seguir, *my-scaling-plan* substitua por suas próprias informações.

```
aws autoscaling-plans describe-scaling-plan-resources \
  --scaling-plan-name my-scaling-plan \
  --scaling-plan-version 1
```

Analise a saída e confirme que você deseja migrar as políticas de escalabilidade descritas. Use essas informações para criar novas políticas de escalabilidade de rastreamento de metas baseadas no Amazon EC2 Auto Scaling e no Application Auto Scaling em. [Etapa 6: reativar o escalonamento dinâmico](#create-target-tracking-scaling-policies)

## Etapa 5: excluir o plano de escalabilidade
<a name="delete-scaling-plan"></a>

Antes de criar novas políticas de escalabilidade de rastreamento de metas, você deve excluir o plano de escalabilidade para excluir as políticas de escalabilidade que ele criou. 

Para excluir seu plano de escalabilidade, use o [delete-scaling-plan](https://docs.aws.amazon.com/cli/latest/reference/autoscaling-plans/delete-scaling-plan.html)comando. No exemplo de comando a seguir, *my-scaling-plan* substitua por suas próprias informações.

```
aws autoscaling-plans delete-scaling-plan \
  --scaling-plan-name my-scaling-plan \
  --scaling-plan-version 1
```

Depois de excluir o plano de escalabilidade, a escalabilidade dinâmica é desativada. Portanto, se houver picos repentinos no tráfego ou na carga de trabalho, a capacidade disponível para cada recurso escalável não aumentará sozinha. Como precaução, talvez você queira aumentar manualmente a capacidade de seus recursos escaláveis no curto prazo.

**Para aumentar a capacidade de um grupo de Auto Scaling**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, escolha Grupos de **Auto Scaling** e, em seguida, escolha o nome do seu grupo de Auto Scaling na lista.

1. Na guia **Detalhes**, escolha **Detalhes do grupo**, **Editar**.

1. Para **Capacidade desejada**, aumente a capacidade desejada.

1. Ao terminar, escolha **Atualizar**.

**Como adicionar uma réplica do Aurora a um cluster de banco de dados**

1. Abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Bancos de dados** e selecione seu cluster de banco de dados.

1. Verifique se o cluster e a instância primária estão no estado **Disponível**.

1. Escolha **Ações**, **Adicionar leitor**.

1. Na página **Adicionar leitor**, especifique as opções para sua nova réplica do Aurora.

1. Escolha **Adicionar leitor**.

**Para aumentar a capacidade de leitura e gravação provisionada de uma tabela do DynamoDB ou índice secundário global**

1. Abra o console do DynamoDB em. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/)

1. No painel de navegação, escolha **Tabelas** e, em seguida, escolha o nome da tabela na lista.

1. **Na guia **Configurações adicionais**, escolha **Capacidade de leitura/gravação**, Editar.**

1. Na página **Editar read/write capacidade**, em Capacidade de **leitura, Unidades de capacidade** **provisionada, aumente a capacidade** de leitura provisionada da tabela.

1. (Opcional) Se você quiser que seus índices secundários globais usem as mesmas configurações de capacidade de leitura da tabela base, marque a caixa de seleção **Usar as mesmas configurações de capacidade de leitura para todos os índices secundários globais**.

1. Para **capacidade de gravação**, **unidades de capacidade provisionada**, aumente a capacidade de gravação provisionada da tabela.

1. (Opcional) Se você quiser que seus índices secundários globais usem as mesmas configurações de capacidade de gravação da tabela base, marque a caixa de seleção **Usar as mesmas configurações de capacidade de gravação para todos os índices secundários globais**.

1. Se você *não marcou* as caixas de seleção nas etapas 5 ou 7, role a página para baixo para atualizar a capacidade de leitura e gravação de qualquer índice secundário global.

1. Escolha **Salvar alterações** para continuar.

**Para aumentar a contagem de tarefas em execução para seu serviço Amazon ECS**

1. Abra o console na [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. No painel de navegação, escolha **Clusters** e, em seguida, escolha o nome do seu cluster na lista.

1. Na seção **Serviços**, marque a caixa de seleção ao lado do serviço e escolha **Atualizar**.

1. Em **Tarefas desejadas**, insira o número de tarefas que você deseja executar no serviço.

1. Selecione **Atualizar**.

**Para aumentar a capacidade de uma frota spot**

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, escolha **Solicitações spot** e selecione sua solicitação de frota spot.

1. Escolha **Actions (Ações)** e **Modify target capacity (Modificar capacidade de destino)**.

1. Em **Modificar capacidade de destino**, insira a nova capacidade de destino e a parte da instância sob demanda.

1. Selecione **Enviar**.

## Etapa 6: reativar o escalonamento dinâmico
<a name="create-target-tracking-scaling-policies"></a>

Reative o escalonamento dinâmico criando políticas de escalabilidade de rastreamento de metas.

Ao criar uma política de escalabilidade de rastreamento de metas para um grupo de Auto Scaling, você a adiciona diretamente ao grupo. Ao criar uma política de escalabilidade de rastreamento de metas para outros recursos escaláveis, primeiro registre o recurso como uma meta escalável e, em seguida, adicione uma política de escalabilidade de rastreamento de metas à meta escalável.

**Topics**
+ [Crie políticas de escalabilidade de rastreamento de metas para grupos de Auto Scaling](#target-tracking-for-auto-scaling-groups)
+ [Crie políticas de escalabilidade de rastreamento de metas para outros recursos escaláveis](#target-tracking-for-other-scalable-resources)

### Crie políticas de escalabilidade de rastreamento de metas para grupos de Auto Scaling
<a name="target-tracking-for-auto-scaling-groups"></a>

**Para criar políticas de escalabilidade de rastreamento de metas para grupos de Auto Scaling**

1. Em um arquivo JSON, crie um `PredefinedMetricSpecification` ou `CustomizedMetricSpecification` use as configurações equivalentes do plano de escalabilidade.

   Veja a seguir exemplos de uma configuração de rastreamento de alvos. Nesses exemplos, substitua cada um *user input placeholder* por suas próprias informações.

------
#### [ With predefined metrics ]

   ```
   {
     "TargetValue": 50.0,
     "PredefinedMetricSpecification": 
       {
         "PredefinedMetricType": "ASGAverageCPUUtilization"
       }
   }
   ```

   Para obter mais informações, consulte a [PredefinedMetricSpecification](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_PredefinedMetricSpecification.html)Referência da API *Amazon EC2 Auto Scaling*.

------
#### [ With custom metrics ]

   ```
   {
     "TargetValue": 100.0,
     "CustomizedMetricSpecification": {
       "MetricName": "MyBacklogPerInstance",
       "Namespace": "MyNamespace",
       "Dimensions": [{
         "Name": "MyOptionalMetricDimensionName",
         "Value": "MyOptionalMetricDimensionValue"
       }],
       "Statistic": "Average",
       "Unit": "None"
     }
   }
   ```

   Para obter mais informações, consulte a [CustomizedMetricSpecification](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_CustomizedMetricSpecification.html)Referência da API *Amazon EC2 Auto Scaling*.

------

1. Para criar sua política de escalabilidade, use o [put-scaling-policy](https://docs.aws.amazon.com/cli/latest/reference/autoscaling/put-scaling-policy.html)comando junto com o arquivo JSON que você criou na etapa anterior. No exemplo a seguir, substitua cada *user input placeholder* por suas próprias informações.

   ```
   aws autoscaling put-scaling-policy --policy-name my-target-tracking-scaling-policy \
     --auto-scaling-group-name my-asg --policy-type TargetTrackingScaling \
     --target-tracking-configuration file://config.json
   ```

1. Repita esse processo para cada política de escalabilidade baseada em plano de escalabilidade que você está migrando para uma política de escalabilidade de rastreamento de metas baseada no Amazon EC2 Auto Scaling.

### Crie políticas de escalabilidade de rastreamento de metas para outros recursos escaláveis
<a name="target-tracking-for-other-scalable-resources"></a>

Em seguida, crie políticas de escalabilidade de rastreamento de metas para outros recursos escaláveis executando as seguintes tarefas de configuração. 
+ Registre uma meta escalável para escalonamento automático com o serviço Application Auto Scaling. 
+ Adicione uma política de escalabilidade de monitoramento do objetivo ao destino escalável.

**Para criar políticas de escalabilidade de rastreamento de metas para outros recursos escaláveis**

1. Use o [register-scalable-target](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/register-scalable-target.html)comando para registrar o recurso como um alvo escalável e definir os limites de escalabilidade para a política de escalabilidade. 

   No exemplo a seguir, substitua cada *user input placeholder* por suas próprias informações. Para as opções de comando, forneça as seguintes informações:
   + `--service-namespace`— Um namespace para o serviço de destino (por exemplo,**`ecs`**). Para obter namespaces de serviço, consulte a [RegisterScalableTarget](https://docs.aws.amazon.com/autoscaling/application/APIReference/API_RegisterScalableTarget.html)referência.
   + `--scalable-dimension`— Uma dimensão escalável associada ao recurso de destino (por exemplo,**`ecs:service:DesiredCount`**). Para obter dimensões escaláveis, consulte a [RegisterScalableTarget](https://docs.aws.amazon.com/autoscaling/application/APIReference/API_RegisterScalableTarget.html)referência.
   + `--resource-id`— Um ID de recurso para o recurso de destino (por exemplo,**`service/my-cluster/my-service`**). Para obter informações sobre a sintaxe e exemplos de recursos específicos IDs, consulte a [RegisterScalableTarget](https://docs.aws.amazon.com/autoscaling/application/APIReference/API_RegisterScalableTarget.html)referência.

   ```
   aws application-autoscaling register-scalable-target --service-namespace namespace \
     --scalable-dimension dimension \
     --resource-id identifier \
     --min-capacity 1 --max-capacity 10
   ```

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

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

1. Em um arquivo JSON, crie um `PredefinedMetricSpecification` ou `CustomizedMetricSpecification` use as configurações equivalentes do plano de escalabilidade.

   Veja a seguir exemplos de uma configuração de rastreamento de alvos.

------
#### [ With predefined metrics ]

   ```
   {
     "TargetValue": 70.0,
     "PredefinedMetricSpecification": 
       {
         "PredefinedMetricType": "ECSServiceAverageCPUUtilization"
       }
   }
   ```

   Para obter mais informações, consulte a Referência [PredefinedMetricSpecification](https://docs.aws.amazon.com/autoscaling/application/APIReference/API_PredefinedMetricSpecification.html)da *API Application Auto Scaling*.

------
#### [ With custom metrics ]

   ```
   {
     "TargetValue": 70.0,
     "CustomizedMetricSpecification": {
       "MetricName": "MyUtilizationMetric",
       "Namespace": "MyNamespace",
       "Dimensions": [{
         "Name": "MyOptionalMetricDimensionName",
         "Value": "MyOptionalMetricDimensionValue"
       }],
       "Statistic": "Average",
       "Unit": "Percent"
     }
   }
   ```

   Para obter mais informações, consulte a Referência [CustomizedMetricSpecification](https://docs.aws.amazon.com/autoscaling/application/APIReference/API_CustomizedMetricSpecification.html)da *API Application Auto Scaling*.

------

1. Para criar sua política de escalabilidade, use o [put-scaling-policy](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/put-scaling-policy.html)comando junto com o arquivo JSON que você criou na etapa anterior.

   ```
   aws application-autoscaling put-scaling-policy --service-namespace namespace \
     --scalable-dimension dimension \
     --resource-id identifier \
     --policy-name my-target-tracking-scaling-policy --policy-type TargetTrackingScaling \
     --target-tracking-scaling-policy-configuration file://config.json
   ```

1. Repita esse processo para cada política de escalabilidade baseada em plano de escalabilidade que você está migrando para uma política de escalabilidade de rastreamento de metas baseada em Application Auto Scaling.

## Etapa 7: reativar a escala preditiva
<a name="switch-predictive-scaling-to-forecast-and-scale"></a>

Se você não usa a escala preditiva, pule esta etapa.

Reative a escalabilidade preditiva trocando a escala preditiva por previsão e escala.

Para fazer essa alteração, atualize os arquivos JSON que você criou [Etapa 2: criar políticas de escalabilidade preditiva](#migrate-predictive-scaling-configurations) e altere o valor da `Mode` opção para `ForecastAndScale` como no exemplo a seguir:

```
"Mode":"ForecastAndScale"
```

Em seguida, atualize cada política de escalabilidade preditiva com o [put-scaling-policy](https://docs.aws.amazon.com/cli/latest/reference/autoscaling/put-scaling-policy.html)comando. Neste exemplo, substitua cada um *user input placeholder* por suas próprias informações.

```
aws autoscaling put-scaling-policy --policy-name my-predictive-scaling-policy \
  --auto-scaling-group-name my-asg --policy-type PredictiveScaling \
  --predictive-scaling-configuration file://my-predictive-scaling-config.json
```

Como alternativa, você pode fazer essa alteração no console do Amazon EC2 Auto Scaling ativando a **escala com base na configuração** de previsão. Para obter mais informações, consulte [Escalabilidade predtiva o Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-predictive-scaling.html) no *Manual do usuário do Amazon EC2 Auto Scaling*.

## Referência do Amazon EC2 Auto Scaling para migrar políticas de escalabilidade de rastreamento de metas
<a name="target-tracking-mapping-reference-ec2-auto-scaling"></a>

Para fins de referência, a tabela a seguir lista todas as propriedades de configuração de rastreamento de destino no plano de escalabilidade com suas propriedades correspondentes na operação da API do Amazon EC2 Auto `PutScalingPolicy` Scaling.


| Propriedade de origem do plano de escalabilidade | Propriedade alvo do Amazon EC2 Auto Scaling | 
| --- | --- | 
| PolicyName | PolicyName | 
| PolicyType | PolicyType | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Dimensions.Name | TargetTrackingConfiguration.CustomizedMetricSpecification.Dimensions.Name | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Dimensions.Value | TargetTrackingConfiguration.CustomizedMetricSpecification.Dimensions.Value | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.MetricName | TargetTrackingConfiguration.CustomizedMetricSpecification.MetricName | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Namespace | TargetTrackingConfiguration.CustomizedMetricSpecification.Namespace | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Statistic | TargetTrackingConfiguration.CustomizedMetricSpecification.Statistic | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Unit | TargetTrackingConfiguration.CustomizedMetricSpecification.Unit | 
| TargetTrackingConfiguration.DisableScaleIn | TargetTrackingConfiguration.DisableScaleIn | 
| TargetTrackingConfiguration.EstimatedInstanceWarmup | TargetTrackingConfiguration.EstimatedInstanceWarmup¹ | 
| TargetTrackingConfiguration.PredefinedScalingMetricSpecification.PredefinedScalingMetricType | TargetTrackingConfiguration.PredefinedMetricSpecification.PredefinedMetricType | 
| TargetTrackingConfiguration.PredefinedScalingMetricSpecification.ResourceLabel | TargetTrackingConfiguration.PredefinedMetricSpecification.ResourceLabel | 
| TargetTrackingConfiguration.ScaleInCooldown | Not available | 
| TargetTrackingConfiguration.ScaleOutCooldown | Not available | 
| TargetTrackingConfiguration.TargetValue | TargetTrackingConfiguration.TargetValue | 

¹ O aquecimento de instâncias é um recurso para grupos de Auto Scaling que ajuda a garantir que as instâncias recém-lançadas estejam prontas para receber tráfego antes de contribuir com seus dados de uso para a métrica de escalabilidade. Enquanto as instâncias ainda estão se aquecendo, o Amazon EC2 Auto Scaling retarda o processo de adição ou remoção de instâncias do grupo. Em vez de especificar um tempo de aquecimento para uma política de escalabilidade, recomendamos que você use a configuração padrão de aquecimento da instância do seu grupo de Auto Scaling para garantir que todas as execuções de instâncias usem o mesmo tempo de aquecimento da instância. Para obter mais informações, consulte [Set the default instance warmup for an Auto Scaling group](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-default-instance-warmup.html) (Definir o aquecimento de instância padrão para um grupo do Auto Scaling) no *Guia do usuário do Amazon EC2 Auto Scaling*.

## Referência do Application Auto Scaling para migrar políticas de escalabilidade de rastreamento de metas
<a name="target-tracking-mapping-reference-application-auto-scaling"></a>

Para fins de referência, a tabela a seguir lista todas as propriedades de configuração de rastreamento de destino no plano de escalabilidade com suas propriedades correspondentes na operação da API Application Auto `PutScalingPolicy` Scaling.


| Propriedade de origem do plano de escalabilidade | Propriedade alvo do Application Auto Scaling | 
| --- | --- | 
| PolicyName | PolicyName | 
| PolicyType | PolicyType | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Dimensions.Name | TargetTrackingScalingPolicyConfiguration.CustomizedMetricSpecification.Dimensions.Name | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Dimensions.Value | TargetTrackingScalingPolicyConfiguration.CustomizedMetricSpecification.Dimensions.Value | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.MetricName | TargetTrackingScalingPolicyConfiguration.CustomizedMetricSpecification.MetricName | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Namespace | TargetTrackingScalingPolicyConfiguration.CustomizedMetricSpecification.Namespace | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Statistic | TargetTrackingScalingPolicyConfiguration.CustomizedMetricSpecification.Statistic | 
| TargetTrackingConfiguration.CustomizedScalingMetricSpecification.Unit | TargetTrackingScalingPolicyConfiguration.CustomizedMetricSpecification.Unit | 
| TargetTrackingConfiguration.DisableScaleIn | TargetTrackingScalingPolicyConfiguration.DisableScaleIn | 
| TargetTrackingConfiguration.EstimatedInstanceWarmup | Not available | 
| TargetTrackingConfiguration.PredefinedScalingMetricSpecification.PredefinedScalingMetricType | TargetTrackingScalingPolicyConfiguration.PredefinedMetricSpecification.PredefinedMetricType | 
| TargetTrackingConfiguration.PredefinedScalingMetricSpecification.ResourceLabel | TargetTrackingScalingPolicyConfiguration.PredefinedMetricSpecification.ResourceLabel | 
| TargetTrackingConfiguration.ScaleInCooldown¹ | TargetTrackingScalingPolicyConfiguration.ScaleInCooldown | 
| TargetTrackingConfiguration.ScaleOutCooldown¹ | TargetTrackingScalingPolicyConfiguration.ScaleOutCooldown | 
| TargetTrackingConfiguration.TargetValue | TargetTrackingScalingPolicyConfiguration.TargetValue | 

¹ O Application Auto Scaling usa períodos de espera para diminuir a escalabilidade quando seu recurso escalável está se expandindo (aumentando a capacidade) e aumentando a escala (reduzindo a capacidade). Para obter mais informações, consulte [Definir períodos de espera](https://docs.aws.amazon.com/autoscaling/application/userguide/target-tracking-scaling-policy-overview.html#target-tracking-cooldown) no *Guia do usuário do Application Auto Scaling*.

## Mais informações
<a name="migrate-scaling-plan-more-info"></a>

Para saber como criar novas políticas de escalabilidade preditiva a partir do console, consulte o tópico a seguir:
+ **Amazon EC2 Auto** [Scaling — Crie uma política de escalabilidade preditiva](https://docs.aws.amazon.com/autoscaling/ec2/userguide/predictive-scaling-create-policy.html) no Guia do usuário do Amazon *EC2 Auto Scaling*.

Para saber como criar novas políticas de escalabilidade de rastreamento de metas usando o console, consulte os tópicos a seguir:
+ **Amazon Aurora** *— [Usando o Amazon Aurora Auto Scaling com réplicas do Aurora no Guia do usuário do Amazon](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Integrating.AutoScaling.html) RDS.*
+ **DynamoDB** *[— Uso do com o Console de gerenciamento da AWS DynamoDB auto scaling no Amazon DynamoDB Developer Guide.](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/AutoScaling.Console.html)*
+ **Amazon EC2 Auto** [Scaling — Crie uma política de escalabilidade de rastreamento de metas](https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-scaling-target-tracking.html#policy_creating) *no Guia do usuário do Amazon EC2 Auto Scaling.*
+ **Amazon ECS** — [Atualização de um serviço usando o console](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html) no *Guia do desenvolvedor do Amazon Elastic Container Service*.
+ **Spot Fleet** — [Dimensione a Spot Fleet usando uma política de rastreamento de alvos](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-target-tracking.html) no *Guia do usuário do Amazon EC2*.