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á.
# Crie ações agendadas para o Application Auto Scaling usando o AWS CLI
Os exemplos a seguir mostram como criar ações agendadas usando o AWS CLI [put-scheduled-action](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/put-scheduled-action.html)comando. Ao especificar a nova capacidade, você pode definir uma capacidade mínima, uma capacidade máxima ou as duas.
Esses exemplos usam destinos escaláveis para alguns dos serviços que se integram ao Application Auto Scaling. Para usar um destino escalável diferente, especifique o respectivo namespace em `--service-namespace`, a dimensão escalável em `--scalable-dimension` e o ID do recurso em `--resource-id`.
Ao usar o AWS CLI, lembre-se de que seus comandos são Região da AWS executados no configurado para seu perfil. Se você deseja executar os comandos em uma região diferente, altere a região padrão para o seu perfil ou use o parâmetro `--region` com o comando.
**Topics**
+ [Criar uma ação programada que ocorre apenas uma vez](#one-time-schedule)
+ [Criar uma ação programada que é executada em um intervalo recorrente](#recurrence-schedule-rate)
+ [Criar uma ação programada que é executada em uma programação recorrente](#recurrence-schedule-cron)
+ [Criar uma única ação programada que especifica um fuso horário](#one-time-schedule-set-time-zone)
+ [Criar uma ação programada recorrente que especifica um fuso horário](#recurring-schedule-set-time-zone)
## Criar uma ação programada que ocorre apenas uma vez
Para escalar automaticamente seu destino escalável apenas uma vez, em uma data e hora especificadas, use o opção `--schedule "at(yyyy-mm-ddThh:mm:ss)"`.
**Example Exemplo: para escalar apenas uma vez**
Veja a seguir um exemplo de criação de uma ação programada para aumentar a escala da capacidade em uma data e hora específicas.
Na data e hora especificadas para `--schedule` (22h UTC em 31 de março de 2021), se o valor especificado para `MinCapacity` estiver acima da capacidade atual, o Application Auto Scaling tera a escala ampliada horizontalmente para `MinCapacity`.
**Linux, macOS ou Unix**
```
aws application-autoscaling put-scheduled-action --service-namespace custom-resource \
--scalable-dimension custom-resource:ResourceType:Property \
--resource-id file://~/custom-resource-id.txt \
--scheduled-action-name scale-out \
--schedule "at(2021-03-31T22:00:00)" \
--scalable-target-action MinCapacity=3
```
**Windows**
```
aws application-autoscaling put-scheduled-action --service-namespace custom-resource ^
--scalable-dimension custom-resource:ResourceType:Property ^
--resource-id file://~/custom-resource-id.txt ^
--scheduled-action-name scale-out ^
--schedule "at(2021-03-31T22:00:00)" ^
--scalable-target-action MinCapacity=3
```
Quando essa ação agendada for executada, se a capacidade máxima for menor que o valor especificado para capacidade mínima, você deverá especificar novas capacidades mínima e máxima, e não apenas a capacidade mínima.
**Example Exemplo: para escalar apenas uma vez**
Veja a seguir um exemplo de criação de uma ação programada para reduzir a escala da capacidade em uma data e hora específicas.
Na data e hora especificadas para `--schedule` (22h30 UTC em 31 de março de 2021), se o valor especificado para `MaxCapacity` estiver abaixo da capacidade atual, o Application Auto Scaling terá a escala reduzida horizontalmente para `MaxCapacity`.
**Linux, macOS ou Unix**
```
aws application-autoscaling put-scheduled-action --service-namespace custom-resource \
--scalable-dimension custom-resource:ResourceType:Property \
--resource-id file://~/custom-resource-id.txt \
--scheduled-action-name scale-in \
--schedule "at(2021-03-31T22:30:00)" \
--scalable-target-action MinCapacity=0,MaxCapacity=0
```
**Windows**
```
aws application-autoscaling put-scheduled-action --service-namespace custom-resource ^
--scalable-dimension custom-resource:ResourceType:Property ^
--resource-id file://~/custom-resource-id.txt ^
--scheduled-action-name scale-in ^
--schedule "at(2021-03-31T22:30:00)" ^
--scalable-target-action MinCapacity=0,MaxCapacity=0
```
## Criar uma ação programada que é executada em um intervalo recorrente
Para agendar a escalabilidade em um intervalo recorrente, use a opção `--schedule "rate(value unit)"`. O valor deve ser um inteiro positivo. A unidade pode ser `minute`, `minutes`, `hour`, `hours`, `day` ou`days`. Para obter mais informações, consulte [Expressões de tarifas](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html#eb-rate-expressions) no *Guia EventBridge do usuário da Amazon*.
Veja a seguir um exemplo de uma ação programada que usa uma expressão de taxa.
Na programação especificada (a cada cinco horas, começando em 30 de janeiro de 2021 à 0h UTC e terminando em 31 de janeiro de 2021 às 22h UTC), se o valor especificado para `MinCapacity` estiver acima da capacidade atual, o Application Auto Scaling aumentará a escala na horizontal para `MinCapacity`. Se o valor especificado para `MaxCapacity` for inferior à capacidade atual, o Application Auto Scaling reduzirá a escala na horizontal para `MaxCapacity`.
**Linux, macOS ou Unix**
```
aws application-autoscaling put-scheduled-action --service-namespace ecs \
--scalable-dimension ecs:service:DesiredCount \
--resource-id service/my-cluster/my-service \
--scheduled-action-name my-recurring-action \
--schedule "rate(5 hours)" \
--start-time 2021-01-30T12:00:00 \
--end-time 2021-01-31T22:00:00 \
--scalable-target-action MinCapacity=3,MaxCapacity=10
```
**Windows**
```
aws application-autoscaling put-scheduled-action --service-namespace ecs ^
--scalable-dimension ecs:service:DesiredCount ^
--resource-id service/my-cluster/my-service ^
--scheduled-action-name my-recurring-action ^
--schedule "rate(5 hours)" ^
--start-time 2021-01-30T12:00:00 ^
--end-time 2021-01-31T22:00:00 ^
--scalable-target-action MinCapacity=3,MaxCapacity=10
```
## Criar uma ação programada que é executada em uma programação recorrente
Para programar a escalabilidade em uma programação recorrente, use a opção `--schedule "cron(fields)"`. Para obter mais informações, consulte [Programar ações de escalabilidade recorrentes usando o Application Auto Scaling](scheduled-scaling-using-cron-expressions.md).
Veja a seguir um exemplo de uma ação programada que usa uma expressão cron.
Na programação especificada (todo dia às 9h UTC), se o valor especificado para `MinCapacity` for superior à capacidade atual, o Application Auto Scaling reduzirá a escala horizontalmente para `MinCapacity`. Se o valor especificado para `MaxCapacity` for inferior à capacidade atual, o Application Auto Scaling reduzirá a escala na horizontal para `MaxCapacity`.
**Linux, macOS ou Unix**
```
aws application-autoscaling put-scheduled-action --service-namespace appstream \
--scalable-dimension appstream:fleet:DesiredCapacity \
--resource-id fleet/sample-fleet \
--scheduled-action-name my-recurring-action \
--schedule "cron(0 9 * * ? *)" \
--scalable-target-action MinCapacity=10,MaxCapacity=50
```
**Windows**
```
aws application-autoscaling put-scheduled-action --service-namespace appstream ^
--scalable-dimension appstream:fleet:DesiredCapacity ^
--resource-id fleet/sample-fleet ^
--scheduled-action-name my-recurring-action ^
--schedule "cron(0 9 * * ? *)" ^
--scalable-target-action MinCapacity=10,MaxCapacity=50
```
## Criar uma única ação programada que especifica um fuso horário
As ações programadas são definidas para o fuso horário UTC por padrão. Para especificar um fuso horário diferente, inclua a opção `--timezone` e especifique o nome canônico do fuso horário (`America/New_York`, por exemplo). Para obter mais informações, consulte [https://www.joda.org/joda-time/timezones.html](https://www.joda.org/joda-time/timezones.html), que fornece informações sobre os fusos horários da IANA que são suportados durante chamadas [put-scheduled-action](https://docs.aws.amazon.com/cli/latest/reference/application-autoscaling/put-scheduled-action.html).
Veja a seguir um exemplo que usa uma opção `--timezone` ao criar uma ação programada para escalar capacidade em uma data e hora específicas.
Na data e hora especificadas para `--schedule` (17h horário local em 31 de janeiro de 2021), se o valor especificado para `MinCapacity` estiver acima da capacidade atual, o Application Auto Scaling terá a escala aumentada horizontalmente para `MinCapacity`. Se o valor especificado para `MaxCapacity` for inferior à capacidade atual, o Application Auto Scaling reduzirá a escala na horizontal para `MaxCapacity`.
**Linux, macOS ou Unix**
```
aws application-autoscaling put-scheduled-action --service-namespace comprehend \
--scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
--resource-id arn:aws:comprehend:us-west-2:123456789012:document-classifier-endpoint/EXAMPLE \
--scheduled-action-name my-one-time-action \
--schedule "at(2021-01-31T17:00:00)" --timezone "America/New_York" \
--scalable-target-action MinCapacity=1,MaxCapacity=3
```
**Windows**
```
aws application-autoscaling put-scheduled-action --service-namespace comprehend ^
--scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits ^
--resource-id arn:aws:comprehend:us-west-2:123456789012:document-classifier-endpoint/EXAMPLE ^
--scheduled-action-name my-one-time-action ^
--schedule "at(2021-01-31T17:00:00)" --timezone "America/New_York" ^
--scalable-target-action MinCapacity=1,MaxCapacity=3
```
## Criar uma ação programada recorrente que especifica um fuso horário
Veja a seguir um exemplo que usa uma opção `--timezone` ao criar uma ação programada recorrente para escalar capacidade. Para obter mais informações, consulte [Programar ações de escalabilidade recorrentes usando o Application Auto Scaling](scheduled-scaling-using-cron-expressions.md).
Na programação especificada (de segunda a sexta-feira às 18h horário local), se o valor especificado para `MinCapacity` for superior à capacidade atual, o Application Auto Scaling aumentará a escala horizontalmente para `MinCapacity`. Se o valor especificado para `MaxCapacity` for inferior à capacidade atual, o Application Auto Scaling reduzirá a escala na horizontal para `MaxCapacity`.
**Linux, macOS ou Unix**
```
aws application-autoscaling put-scheduled-action --service-namespace lambda \
--scalable-dimension lambda:function:ProvisionedConcurrency \
--resource-id function:my-function:BLUE \
--scheduled-action-name my-recurring-action \
--schedule "cron(0 18 ? * MON-FRI *)" --timezone "Etc/GMT+9" \
--scalable-target-action MinCapacity=10,MaxCapacity=50
```
**Windows**
```
aws application-autoscaling put-scheduled-action --service-namespace lambda ^
--scalable-dimension lambda:function:ProvisionedConcurrency ^
--resource-id function:my-function:BLUE ^
--scheduled-action-name my-recurring-action ^
--schedule "cron(0 18 ? * MON-FRI *)" --timezone "Etc/GMT+9" ^
--scalable-target-action MinCapacity=10,MaxCapacity=50
```