# Exemplos do Application Auto Scaling usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a AWS Command Line Interface com o Application Auto Scaling.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `delete-scaling-policy`
O código de exemplo a seguir mostra como usar `delete-scaling-policy`.
**AWS CLI**
**Para excluir uma política de escalabilidade**
Este exemplo exclui uma política de escalabilidade para a aplicação web do serviço Amazon ECS em execução no cluster padrão.
Comando:
```
aws application-autoscaling delete-scaling-policy --policy-name web-app-cpu-lt-25 --scalable-dimension ecs:service:DesiredCount --resource-id service/default/web-app --service-namespace ecs
```
+ Para ver detalhes da API, consulte [DeleteScalingPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/delete-scaling-policy.html) na *Referência de comandos da AWS CLI*.
### `delete-scheduled-action`
O código de exemplo a seguir mostra como usar `delete-scheduled-action`.
**AWS CLI**
**Para excluir uma ação programada**
O exemplo `delete-scheduled-action` a seguir exclui a ação programada especificada da frota especificada do Amazon AppStream 2.0:
```
aws application-autoscaling delete-scheduled-action \
--service-namespace appstream \
--scalable-dimension appstream:fleet:DesiredCapacity \
--resource-id fleet/sample-fleet \
--scheduled-action-name my-recurring-action
```
Este comando não produz saída.
Para obter mais informações, consulte [Escalabilidade programada](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scheduled-scaling.html) no *Guia do usuário do Application Auto Scaling*.
+ Para ver detalhes da API, consulte [DeleteScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/delete-scheduled-action.html) na *Referência de comandos da AWS CLI*.
### `deregister-scalable-target`
O código de exemplo a seguir mostra como usar `deregister-scalable-target`.
**AWS CLI**
**Como cancelar o registro de um destino escalável**
Este exemplo cancela o registro de um destino escalável para um serviço do Amazon ECS chamado web-app que está sendo executado no cluster padrão.
Comando:
```
aws application-autoscaling deregister-scalable-target --service-namespace ecs --scalable-dimension ecs:service:DesiredCount --resource-id service/default/web-app
```
Este exemplo cancela o registro de uma meta escalável para um recurso personalizado. O arquivo custom-resource-id.txt contém uma string que identifica o ID do recurso, que, para um recurso personalizado, é o caminho para o recurso personalizado por meio do endpoint do Amazon API Gateway.
Comando:
```
aws application-autoscaling deregister-scalable-target --service-namespace custom-resource --scalable-dimension custom-resource:ResourceType:Property --resource-id file://~/custom-resource-id.txt
```
Conteúdo do arquivo custom-resource-id.txt:
```
https://example.execute-api.us-west-2.amazonaws.com/prod/scalableTargetDimensions/1-23456789
```
+ Para ver detalhes da API, consulte [DeregisterScalableTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/deregister-scalable-target.html) na *Referência de comandos da AWS CLI*.
### `describe-scalable-targets`
O código de exemplo a seguir mostra como usar `describe-scalable-targets`.
**AWS CLI**
**Para descrever destinos escaláveis**
O exemplo `describe-scalable-targets` a seguir descreve os destinos escaláveis para o namespace do serviço `ecs`.
```
aws application-autoscaling describe-scalable-targets \
--service-namespace ecs
```
Resultado:
```
{
"ScalableTargets": [
{
"ServiceNamespace": "ecs",
"ScalableDimension": "ecs:service:DesiredCount",
"ResourceId": "service/default/web-app",
"MinCapacity": 1,
"MaxCapacity": 10,
"RoleARN": "arn:aws:iam::123456789012:role/aws-service-role/ecs.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_ECSService",
"CreationTime": 1462558906.199,
"SuspendedState": {
"DynamicScalingOutSuspended": false,
"ScheduledScalingSuspended": false,
"DynamicScalingInSuspended": false
},
"ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}
]
}
```
Para obter mais informações, consulte [Serviços da AWS que podem ser usados com o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/integrated-services-list.html) no *Guia do usuário do Application Auto Scaling*.
+ Para ver detalhes da API, consulte [DescribeScalableTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/describe-scalable-targets.html) na *Referência de comandos da AWS CLI*.
### `describe-scaling-activities`
O código de exemplo a seguir mostra como usar `describe-scaling-activities`.
**AWS CLI**
**Exemplo 1: descrever as atividades de ajuste de escala do serviço do Amazon ECS especificado**
O exemplo `describe-scaling-activities` a seguir descreve as atividades de escalabilidade de um serviço do Amazon ECS chamado `web-app` que está sendo executado no cluster `default`. A saída mostra uma atividade de ajuste de escala iniciada por uma política de ajuste de escala.
```
aws application-autoscaling describe-scaling-activities \
--service-namespace ecs \
--resource-id service/default/web-app
```
Resultado:
```
{
"ScalingActivities": [
{
"ScalableDimension": "ecs:service:DesiredCount",
"Description": "Setting desired count to 1.",
"ResourceId": "service/default/web-app",
"ActivityId": "e6c5f7d1-dbbb-4a3f-89b2-51f33e766399",
"StartTime": 1462575838.171,
"ServiceNamespace": "ecs",
"EndTime": 1462575872.111,
"Cause": "monitor alarm web-app-cpu-lt-25 in state ALARM triggered policy web-app-cpu-lt-25",
"StatusMessage": "Successfully set desired count to 1. Change successfully fulfilled by ecs.",
"StatusCode": "Successful"
}
]
}
```
Para obter mais informações, consulte [Atividades de escalabilidade para o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scaling-activities.html) no *Guia do usuário do Application Auto Scaling*.
**Exemplo 2: descrever as ações de ajuste de escala da tabela do DynamoDB especificada**
O exemplo `describe-scaling-activities` a seguir descreve as atividades de ajuste de escala de uma tabela do DynamoDB chamada `TestTable`. O resultado mostra as atividades de ajuste de escala iniciadas por duas ações agendadas diferentes.
```
aws application-autoscaling describe-scaling-activities \
--service-namespace dynamodb \
--resource-id table/TestTable
```
Resultado:
```
{
"ScalingActivities": [
{
"ScalableDimension": "dynamodb:table:WriteCapacityUnits",
"Description": "Setting write capacity units to 10.",
"ResourceId": "table/my-table",
"ActivityId": "4d1308c0-bbcf-4514-a673-b0220ae38547",
"StartTime": 1561574415.086,
"ServiceNamespace": "dynamodb",
"EndTime": 1561574449.51,
"Cause": "maximum capacity was set to 10",
"StatusMessage": "Successfully set write capacity units to 10. Change successfully fulfilled by dynamodb.",
"StatusCode": "Successful"
},
{
"ScalableDimension": "dynamodb:table:WriteCapacityUnits",
"Description": "Setting min capacity to 5 and max capacity to 10",
"ResourceId": "table/my-table",
"ActivityId": "f2b7847b-721d-4e01-8ef0-0c8d3bacc1c7",
"StartTime": 1561574414.644,
"ServiceNamespace": "dynamodb",
"Cause": "scheduled action name my-second-scheduled-action was triggered",
"StatusMessage": "Successfully set min capacity to 5 and max capacity to 10",
"StatusCode": "Successful"
},
{
"ScalableDimension": "dynamodb:table:WriteCapacityUnits",
"Description": "Setting write capacity units to 15.",
"ResourceId": "table/my-table",
"ActivityId": "d8ea4de6-9eaa-499f-b466-2cc5e681ba8b",
"StartTime": 1561574108.904,
"ServiceNamespace": "dynamodb",
"EndTime": 1561574140.255,
"Cause": "minimum capacity was set to 15",
"StatusMessage": "Successfully set write capacity units to 15. Change successfully fulfilled by dynamodb.",
"StatusCode": "Successful"
},
{
"ScalableDimension": "dynamodb:table:WriteCapacityUnits",
"Description": "Setting min capacity to 15 and max capacity to 20",
"ResourceId": "table/my-table",
"ActivityId": "3250fd06-6940-4e8e-bb1f-d494db7554d2",
"StartTime": 1561574108.512,
"ServiceNamespace": "dynamodb",
"Cause": "scheduled action name my-first-scheduled-action was triggered",
"StatusMessage": "Successfully set min capacity to 15 and max capacity to 20",
"StatusCode": "Successful"
}
]
}
```
Para obter mais informações, consulte [Atividades de escalabilidade para o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scaling-activities.html) no *Guia do usuário do Application Auto Scaling*.
+ Consulte detalhes da API em [DescribeScalingActivities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/describe-scaling-activities.html) na *Referência de comandos AWS CLI*.
### `describe-scaling-policies`
O código de exemplo a seguir mostra como usar `describe-scaling-policies`.
**AWS CLI**
**Para descrever políticas de ajuste de escala**
Este exemplo de comando descreve as políticas de ajuste de escala para o namespace do serviço ecs.
Comando:
```
aws application-autoscaling describe-scaling-policies --service-namespace ecs
```
Resultado:
```
{
"ScalingPolicies": [
{
"PolicyName": "web-app-cpu-gt-75",
"ScalableDimension": "ecs:service:DesiredCount",
"ResourceId": "service/default/web-app",
"CreationTime": 1462561899.23,
"StepScalingPolicyConfiguration": {
"Cooldown": 60,
"StepAdjustments": [
{
"ScalingAdjustment": 200,
"MetricIntervalLowerBound": 0.0
}
],
"AdjustmentType": "PercentChangeInCapacity"
},
"PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-gt-75",
"PolicyType": "StepScaling",
"Alarms": [
{
"AlarmName": "web-app-cpu-gt-75",
"AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-gt-75"
}
],
"ServiceNamespace": "ecs"
},
{
"PolicyName": "web-app-cpu-lt-25",
"ScalableDimension": "ecs:service:DesiredCount",
"ResourceId": "service/default/web-app",
"CreationTime": 1462562575.099,
"StepScalingPolicyConfiguration": {
"Cooldown": 1,
"StepAdjustments": [
{
"ScalingAdjustment": -50,
"MetricIntervalUpperBound": 0.0
}
],
"AdjustmentType": "PercentChangeInCapacity"
},
"PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-lt-25",
"PolicyType": "StepScaling",
"Alarms": [
{
"AlarmName": "web-app-cpu-lt-25",
"AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-lt-25"
}
],
"ServiceNamespace": "ecs"
}
]
}
```
+ Para ver detalhes da API, consulte [DescribeScalingPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/describe-scaling-policies.html) na *Referência de comandos da AWS CLI*.
### `describe-scheduled-actions`
O código de exemplo a seguir mostra como usar `describe-scheduled-actions`.
**AWS CLI**
**Para descrever ações programadas**
O exemplo `describe-scheduled-actions` a seguir exibe detalhes das ações agendadas para o namespace de serviço especificado:
```
aws application-autoscaling describe-scheduled-actions \
--service-namespace dynamodb
```
Resultado:
```
{
"ScheduledActions": [
{
"ScalableDimension": "dynamodb:table:WriteCapacityUnits",
"Schedule": "at(2019-05-20T18:35:00)",
"ResourceId": "table/my-table",
"CreationTime": 1561571888.361,
"ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-first-scheduled-action",
"ScalableTargetAction": {
"MinCapacity": 15,
"MaxCapacity": 20
},
"ScheduledActionName": "my-first-scheduled-action",
"ServiceNamespace": "dynamodb"
},
{
"ScalableDimension": "dynamodb:table:WriteCapacityUnits",
"Schedule": "at(2019-05-20T18:40:00)",
"ResourceId": "table/my-table",
"CreationTime": 1561571946.021,
"ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-second-scheduled-action",
"ScalableTargetAction": {
"MinCapacity": 5,
"MaxCapacity": 10
},
"ScheduledActionName": "my-second-scheduled-action",
"ServiceNamespace": "dynamodb"
}
]
}
```
Para obter mais informações, consulte [Escalabilidade programada](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scheduled-scaling.html) no *Guia do usuário do Application Auto Scaling*.
+ Para ver detalhes da API, consulte [DescribeScheduledActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/describe-scheduled-actions.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Para listar as tags de um destino escalável**
O exemplo `list-tags-for-resource` a seguir lista os nomes e valores das chaves de tag que estão anexados ao destino escalável especificado por seu ARN.
```
aws application-autoscaling list-tags-for-resource \
--resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123
```
Resultado:
```
{
"Tags": {
"environment": "production"
}
}
```
Para obter mais informações, consulte [Suporte à marcação para o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/resource-tagging-support.html) no *Guia do usuário do Application Auto Scaling*.
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `put-scaling-policy`
O código de exemplo a seguir mostra como usar `put-scaling-policy`.
**AWS CLI**
**Exemplo 1: como aplicar uma política de escalabilidade com monitoramento do objetivo com uma especificação de métrica predefinida**
O exemplo `put-scaling-policy` a seguir aplica uma política de ajuste de escala de rastreamento de destino com uma especificação de métrica predefinida a um serviço do ECS chamado web-app no cluster padrão. A política mantém a utilização média da CPU do serviço em 75%, com períodos de espera de aumento e redução de escala horizontalmente de 60 segundos. A saída contém os ARNs e os nomes dos dois alarmes do CloudWatch criados em seu nome.
```
aws application-autoscaling put-scaling-policy --service-namespace ecs \
--scalable-dimension ecs:service:DesiredCount \
--resource-id service/default/web-app \
--policy-name cpu75-target-tracking-scaling-policy --policy-type TargetTrackingScaling \
--target-tracking-scaling-policy-configuration file://config.json
```
Este exemplo pressupõe que você tenha um arquivo config.json no diretório atual com o seguinte conteúdo:
```
{
"TargetValue": 75.0,
"PredefinedMetricSpecification": {
"PredefinedMetricType": "ECSServiceAverageCPUUtilization"
},
"ScaleOutCooldown": 60,
"ScaleInCooldown": 60
}
```
Resultado:
```
{
"PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/cpu75-target-tracking-scaling-policy",
"Alarms": [
{
"AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca",
"AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca"
},
{
"AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmLow-1b437334-d19b-4a63-a812-6c67aaf2910d",
"AlarmName": "TargetTracking-service/default/web-app-AlarmLow-1b437334-d19b-4a63-a812-6c67aaf2910d"
}
]
}
```
**Exemplo 2: como aplicar uma política de escalabilidade com monitoramento do objetivo com uma especificação de métrica personalizada**
O exemplo `put-scaling-policy` a seguir aplica uma política de ajuste de escala de rastreamento de destino com uma especificação de métrica personalizada a um serviço do ECS chamado web-app no cluster padrão. A política mantém a utilização média do serviço em 75%, com períodos de espera de aumento e redução de escala horizontalmente de 60 segundos. A saída contém os ARNs e os nomes dos dois alarmes do CloudWatch criados em seu nome.
```
aws application-autoscaling put-scaling-policy --service-namespace ecs \
--scalable-dimension ecs:service:DesiredCount \
--resource-id service/default/web-app \
--policy-name cms75-target-tracking-scaling-policy
--policy-type TargetTrackingScaling \
--target-tracking-scaling-policy-configuration file://config.json
```
Este exemplo pressupõe que você tenha um arquivo config.json no diretório atual com o seguinte conteúdo:
```
{
"TargetValue":75.0,
"CustomizedMetricSpecification":{
"MetricName":"MyUtilizationMetric",
"Namespace":"MyNamespace",
"Dimensions": [
{
"Name":"MyOptionalMetricDimensionName",
"Value":"MyOptionalMetricDimensionValue"
}
],
"Statistic":"Average",
"Unit":"Percent"
},
"ScaleOutCooldown": 60,
"ScaleInCooldown": 60
}
```
Resultado:
```
{
"PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy: 8784a896-b2ba-47a1-b08c-27301cc499a1:resource/ecs/service/default/web-app:policyName/cms75-target-tracking-scaling-policy",
"Alarms": [
{
"AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmHigh-9bc77b56-0571-4276-ba0f-d4178882e0a0",
"AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-9bc77b56-0571-4276-ba0f-d4178882e0a0"
},
{
"AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmLow-9b6ad934-6d37-438e-9e05-02836ddcbdc4",
"AlarmName": "TargetTracking-service/default/web-app-AlarmLow-9b6ad934-6d37-438e-9e05-02836ddcbdc4"
}
]
}
```
**Exemplo 3: como aplicar uma política de escalabilidade com monitoramento do objetivo somente para expansão**
O exemplo `put-scaling-policy` a seguir aplica uma política de ajuste de escala de rastreamento de destino a um serviço do ECS chamado `web-app` no cluster padrão. A política é usada para aumentar a escala horizontalmente o serviço ECS quando a métrica `RequestCountPerTarget` do Application Load Balancer excede o limite. A saída contém o ARN e o nome do alarme do CloudWatch criado em seu nome.
```
aws application-autoscaling put-scaling-policy \
--service-namespace ecs \
--scalable-dimension ecs:service:DesiredCount \
--resource-id service/default/web-app \
--policy-name alb-scale-out-target-tracking-scaling-policy \
--policy-type TargetTrackingScaling \
--target-tracking-scaling-policy-configuration file://config.json
```
Conteúdo de `config.json`:
```
{
"TargetValue": 1000.0,
"PredefinedMetricSpecification": {
"PredefinedMetricType": "ALBRequestCountPerTarget",
"ResourceLabel": "app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d"
},
"ScaleOutCooldown": 60,
"ScaleInCooldown": 60,
"DisableScaleIn": true
}
```
Resultado:
```
{
"PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/alb-scale-out-target-tracking-scaling-policy",
"Alarms": [
{
"AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca",
"AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca"
}
]
}
```
Para obter mais informações, consulte [Políticas de ajuste de escala de rastreamento de destino para o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) no *Guia do usuário do AWS Application Auto Scaling*.
+ Para ver detalhes da API, consulte [PutScalingPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/put-scaling-policy.html) na *Referência de comandos da AWS CLI*.
### `put-scheduled-action`
O código de exemplo a seguir mostra como usar `put-scheduled-action`.
**AWS CLI**
**Para adicionar uma ação programada a uma tabela do DynamoDB**
Este exemplo adiciona uma ação programada a uma tabela do DynamoDB chamada TestTable para aumentar a escala horizontalmente de acordo com uma programação recorrente. Na programação que especificou (todo dia às 12:15 UTC), se a capacidade atual estiver abaixo do valor especificado para MinCapacity, o Application Auto Scaling aumenta a escala horizontalmente do valor especificado para MinCapacity.
Comando:
```
aws application-autoscaling put-scheduled-action --service-namespace dynamodb --scheduled-action-name my-recurring-action --schedule "cron(15 12 * * ? *)" --resource-id table/TestTable --scalable-dimension dynamodb:table:WriteCapacityUnits --scalable-target-action MinCapacity=6
```
Para obter mais informações, consulte Escalabilidade programada no *Guia do usuário do Application Auto Scaling*.
+ Para ver detalhes da API, consulte [PutScheduledAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/put-scheduled-action.html) na *Referência de comandos da AWS CLI*.
### `register-scalable-target`
O código de exemplo a seguir mostra como usar `register-scalable-target`.
**AWS CLI**
**Exemplo 1: registrar um serviço ECS como um destino escalável**
O exemplo `register-scalable-target` a seguir inscreve um serviço do Amazon ECS com o Application Auto Scaling. Ele também adiciona uma tag com o nome `environment` e o valor `production` da chave ao destino escalável.
```
aws application-autoscaling register-scalable-target \
--service-namespace ecs \
--scalable-dimension ecs:service:DesiredCount \
--resource-id service/default/web-app \
--min-capacity 1 --max-capacity 10 \
--tags environment=production
```
Resultado:
```
{
"ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}
```
Para obter exemplos de outros serviços e recursos personalizados da AWS, consulte os tópicos em [Serviços da AWS que você pode usar com o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/integrated-services-list.html) no *Guia do Usuário do Application Auto Scaling*.
**Exemplo 2: suspender as atividades de escalabilidade de um destino escalável**
O exemplo `register-scalable-target` a seguir suspende as atividades de ajuste de escala de um destino escalável existente.
```
aws application-autoscaling register-scalable-target \
--service-namespace dynamodb \
--scalable-dimension dynamodb:table:ReadCapacityUnits \
--resource-id table/my-table \
--suspended-state DynamicScalingInSuspended=true,DynamicScalingOutSuspended=true,ScheduledScalingSuspended=true
```
Resultado:
```
{
"ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}
```
Para obter mais informações, consulte [Como suspender e retomar o ajuste de escala do Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-suspend-resume-scaling.html) no *Guia do usuário do Application Auto Scaling*.
**Exemplo 3: retomar as atividades de escalabilidade para um destino escalável**
O exemplo `register-scalable-target` a seguir retoma as atividades de ajuste de escala de um destino escalável existente.
```
aws application-autoscaling register-scalable-target \
--service-namespace dynamodb \
--scalable-dimension dynamodb:table:ReadCapacityUnits \
--resource-id table/my-table \
--suspended-state DynamicScalingInSuspended=false,DynamicScalingOutSuspended=false,ScheduledScalingSuspended=false
```
Resultado:
```
{
"ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}
```
Para obter mais informações, consulte [Como suspender e retomar o ajuste de escala do Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-suspend-resume-scaling.html) no *Guia do usuário do Application Auto Scaling*.
+ Para ver detalhes da API, consulte [RegisterScalableTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/register-scalable-target.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Para adicionar uma tag a um destino escalável**
O exemplo `tag-resource` a seguir adiciona uma tag com o nome `environment` e o valor `production` da chave ao destino escalável especificado por seu ARN.
```
aws application-autoscaling tag-resource \
--resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 \
--tags environment=production
```
Este comando não produz saída.
Para obter mais informações, consulte [Suporte à marcação para o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/resource-tagging-support.html) no *Guia do usuário do Application Auto Scaling*.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover uma tag de um destino escalável**
O exemplo `untag-resource` a seguir remove o par de tags com o nome `environment` da chave do destino escalável especificado por seu ARN.
```
aws application-autoscaling untag-resource \
--resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 \
--tag-keys "environment"
```
Este comando não produz saída.
Para obter mais informações, consulte [Suporte à marcação para o Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/resource-tagging-support.html) no *Guia do usuário do Application Auto Scaling*.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/untag-resource.html) na *Referência de comandos da AWS CLI*.