• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
# Referência: Expressões cron e rate para o Systems Manager
Ao criar uma associação do State Manager ou uma janela de manutenção no AWS Systems Manager, você especifica uma programação para quando a janela ou a associação deve ser executada. É possível especificar um agendamento como uma entrada baseada em horário, chamada de *expressão cron*, ou como uma entrada baseada em frequência, chamada de *expressão rate*.
## Informações gerais sobre as expressões cron e rate
As informações a seguir são aplicáveis a expressões cron e rate para janelas de manutenção e associações.
**Programações com execução única**
Ao criar uma associação ou uma janela de manutenção, é possível especificar um carimbo de data/hora no formato Tempo Universal Coordenado (UTC) para que ela seja executada uma vez no horário especificado. Por exemplo, .: `"at(2020-07-07T15:55:00)"`
**Deslocamentos de programação**
Associações e janelas de manutenção oferecem suporte a *deslocamentos de programação* apenas para expressões cron. Um deslocamento de programação é o número de dias de espera após a data e a hora especificadas por uma expressão do cron antes de executar a associação ou janela de manutenção.
No exemplo acima, a expressão CRON agenda a execução de uma janela de manutenção na terceira terça-feira de cada mês às 23h30. No entanto, como o deslocamento de programação é `2`, a janela de manutenção só será executada dois dias depois às 23h30.
```
aws ssm create-maintenance-window \
--name "My-Cron-Offset-Maintenance-Window" \
--allow-unassociated-targets \
--schedule "cron(30 23 ? * TUE#3 *)" \
--duration 4 \
--cutoff 1 \
--schedule-offset 2
```
No comando a seguir, a expressão cron agenda uma associação para ser executada na segunda quinta-feira de cada mês. No entanto, como a diferença de cronograma é `3`, a associação não funcionará até o próximo domingo, três dias depois.
```
aws ssm create-association \
--name "AWS-UpdateSSMAgent" \
--targets "Key=instanceids,Values=i-0cb2b964d3e14fd9f" \
--schedule-expression "cron(0 0 ? * THU#2 *)" \
--schedule-offset 3
--apply-only-at-cron-interval
```
Para usar um deslocamento com uma associação, você deve especificar a opção `--apply-only-at-cron-interval`. Essa opção diz ao sistema para não executar uma associação imediatamente após sua criação.
Se você criar uma associação ou janela de manutenção com uma expressão do cron que tenha como destino um dia que já passou em relação ao período atual, mas adicionar uma data futura de deslocamento de programação, a associação ou janela de manutenção não será executada no período. Ela entrará em vigor no período seguinte. Por exemplo, se você especificar uma expressão cron que teria executado uma janela de manutenção ontem e adicionar um deslocamento de programação de dois dias, a janela de manutenção não será executada amanhã.
**Campos obrigatórios**
Expressões cron para janelas de manutenção têm seis campos obrigatórios. Expressões cron para associações têm cinco. (no momento, o State Manager não oferece suporte à especificação de meses em expressões cron para associações.) Um campo adicional, o campo `Seconds` (o primeiro em uma expressão cron), é opcional. Os campos são separados por um espaço.
**Exemplos de expressão cron**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html)
Intervalos de dias da semana (como `MON-FRI`) e listas de dias separadas por vírgula (como `MON,TUE,WED`) são compatíveis apenas para janelas de manutenção. Para associações, você deve especificar um único dia (como `MON`) ou usar `*` para cada dia.
**Valores com suporte**
A tabela a seguir mostra os valores compatíveis com as entradas cron necessárias.
**Valores compatíveis com expressões cron**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html)
Não é possível especificar os campos de dia do mês e dia da semana na mesma expressão cron. Se você especificar um valor em um dos campos, use um ? (ponto de interrogação) no outro.
**Curingas para expressões cron**
A tabela a seguir mostra os valores curinga compatíveis com expressões cron.
As expressões Cron que levam a taxas mais rápidas do que 5 (cinco) minutos não têm suporte. O suporte para especificar um valor de dia da semana e dia do mês ao mesmo tempo não está completo. Use o ponto de interrogação (?) em um desses campos.
**Curingas compatíveis com expressões cron**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html)
**Expressões rate**
Expressões rate têm os seguintes dois campos obrigatórios. Os campos são separados por espaços.
**Campos obrigatórios para expressões rate**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html)
Se o valor for igual a `1`, a unidade deverá ser singular. Da mesma forma, para valores maiores do que `1`, a unidade deve ser plural. Por exemplo, `rate(1 hours)` e `rate(5 hour)` não são válidas, mas `rate(1 hour)` e `rate(5 hours)` são.
**Topics**
+ [Informações gerais sobre as expressões cron e rate](#reference-cron-and-rate-expressions-intro)
+ [Expressões cron e rate para associações](#reference-cron-and-rate-expressions-association)
+ [Expressões cron e rate para janelas de manutenção](#reference-cron-and-rate-expressions-maintenance-window)
## Expressões cron e rate para associações
Esta seção inclui exemplos de associações do State Manager com expressões cron e rate. Antes de criar uma dessas expressões, fique atento às informações a seguir:
+ As associações comportam as seguintes expressões cron: a cada 1/2, 1, 2, 4, 8 ou 12 horas; todo dia, toda semana ou cada dia e hora especificados da semana; um dia específico em uma semana específica do mês ou o último `x` dia do mês na hora específica.
+ As associações comportam apenas as seguintes expressões de taxas: intervalos de 30 minutos ou mais e menos de 31 dias.
+ Se você especificar o campo opcional `Seconds`, o valor poderá ser 0 (zero). Por exemplo: `cron(0 */30 * * * ? *)`
+ Para uma associação que coleta metadados para o Inventory, uma ferramenta do AWS Systems Manager, recomendamos o uso de uma expressão rate.
+ Atualmente, o State Manager não oferece suporte à especificação de meses em expressões cron para associações.
Associações comportam expressões do cron que incluem um dia da semana e o sinal numérico (\$1) para designar o *n*º dia de um mês para executar uma associação. Aqui está um exemplo que executa uma programação do cron na terceira terça-feira de cada mês às 23h30 UTC:
`cron(30 23 ? * TUE#3 *)`
Aqui está um exemplo que acontece na segunda quinta-feira de cada mês à meia-noite UTC:
`cron(0 0 ? * THU#2 *)`
Associações também aceitam o sinal (L) para indicar o último dia *X* do mês. Aqui está um exemplo que executa uma programação do cron na última terça-feira de cada mês à meia-noite UTC:
`cron(0 0 ? * 3L *)`
Para controlar ainda mais quando uma associação é executada, por exemplo, se você quiser executar uma associação dois dias após o patch de terça-feira, você pode especificar um deslocamento. Um *deslocamento* define quantos dias esperar após o dia programado para executar uma associação. Por exemplo, se você especificou uma programação do cron de `cron(0 0 ? * THU#2 *)`, você pode especificar o número 3 no campo **Schedule offset** (Deslocamento da programação) para executar a associação todos os domingos após a segunda quinta-feira do mês.
Para usar deslocamentos, você deve escolher a opção **Apply association only at the next specified Cron interval** (Aplicar associação somente no próximo intervalo de Cron especificado) no console ou você deve especificar o parâmetro de uso `--apply-only-at-cron-interval` a partir da linha de comando. Essa opção diz ao State Manager para não executar uma associação imediatamente após sua criação.
A tabela a seguir apresenta exemplos cron para associações.
**Exemplos de cron para associações**
| Exemplo | Detalhes |
| --- | --- |
| cron(0/30 \$1 \$1 \$1 ? \$1) | A cada 30 minutos |
| cron(0 0/1 \$1 \$1 ? \$1) | A cada hora |
| cron(0 0/2 \$1 \$1 ? \$1) | A cada 2 horas |
| cron(0 0/4 \$1 \$1 ? \$1) | A cada 4 horas |
| cron(0 0/8 \$1 \$1 ? \$1) | A cada 8 horas |
| cron(0 0/12 \$1 \$1 ? \$1) | A cada 12 horas |
| cron(15 13 ? \$1 \$1 \$1) | Todos os dia às 13h15 |
| cron(15 13 ? \$1 MON \$1) | Todas as segundas às 13h15 |
| cron(30 23 ? \$1 TUE\$13 \$1) | A terceira terça-feira de cada mês às 23h30 |
Veja alguns exemplos de associações com rate.
**Exemplos de rate para associações**
| Exemplo | Detalhes |
| --- | --- |
| rate(30 minutes) | A cada 30 minutos |
| rate(1 hour) | A cada hora |
| rate(5 hours) | A cada 5 horas |
| rate(15 days) | A cada 15 dias |
****AWS CLI Exemplos da para associações****
Para criar associações State Manager usando a AWS CLI, inclua o parâmetro `--schedule-expression` com uma expressão cron ou rate. Os exemplos a seguir usam a AWS CLI em uma máquina Linux local.
**nota**
Por padrão, quando você cria uma nova associação, o sistema a executa imediatamente após sua criação e de acordo com a programação especificada. Especifique `--apply-only-at-cron-interval` para que a associação não seja executada imediatamente após a criação. Esse parâmetro não é compatível com expressões rate.
```
aws ssm create-association \
--association-name "My-Cron-Association" \
--schedule-expression "cron(0 2 ? * SUN *)" \
--targets Key=tag:ServerRole,Values=WebServer \
--name AWS-UpdateSSMAgent
```
```
aws ssm create-association \
--association-name "My-Rate-Association" \
--schedule-expression "rate(7 days)" \
--targets Key=tag:ServerRole,Values=WebServer \
--name AWS-UpdateSSMAgent
```
```
aws ssm create-association \
--association-name "My-Rate-Association" \
--schedule-expression "at(2020-07-07T15:55:00)" \
--targets Key=tag:ServerRole,Values=WebServer \
--name AWS-UpdateSSMAgent \
--apply-only-at-cron-interval
```
## Expressões cron e rate para janelas de manutenção
Esta seção inclui exemplos de expressões cron e rate para janelas de manutenção.
Ao contrário das associações do State Manager, as janelas de manutenção são compatíveis com todas as expressões cron e de taxa. Isso inclui suporte para valores no campo de segundos.
Por exemplo, a expressão cron de 6 campos a seguir executa uma janela de manutenção às 9:30 AM todos os dias.
```
cron(30 09 ? * * *)
```
Ao adicionar um valor ao campo `Seconds`, a expressão cron de 7 campos a seguir executa uma janela de manutenção às 9:30:24 hs todos os dias.
```
cron(24 30 09 ? * * *)
```
A tabela a seguir fornece exemplos adicionais de cron de 6 campos para janelas de manutenção.
**Exemplos de cron para janelas de manutenção**
| Exemplo | Detalhes |
| --- | --- |
| cron(0 2 ? \$1 THU\$13 \$1) | 02:00, na terceira quinta-feira de cada mês |
| cron(15 10 ? \$1 \$1 \$1) | 10:15, todos os dias |
| cron(15 10 ? \$1 MON-FRI \$1) | 10:15 todas as segundas, terças, quartas, quintas e sexta-feiras |
| cron(0 2 L \$1 ? \$1) | 02:00, no último dia de cada mês |
| cron(15 10 ? \$1 6L \$1) | 10:15, na última sexta-feira de cada mês |
A tabela a seguir fornece exemplos de rate para janelas de manutenção.
**Exemplos de rate para janelas de manutenção**
| Exemplo | Detalhes |
| --- | --- |
| rate(30 minutes) | A cada 30 minutos |
| rate(1 hour) | A cada hora |
| rate(5 hours) | A cada 5 horas |
| rate(25 days) | A cada 25 dias |
****AWS CLI Exemplos de para janelas de manutenção****
Para criar janelas de manutenção usando a AWS CLI, inclua o parâmetro `--schedule` com uma expressão cron ou rate ou um carimbo de data/hora. Os exemplos a seguir usam a AWS CLI em uma máquina Linux local.
```
aws ssm create-maintenance-window \
--name "My-Cron-Maintenance-Window" \
--allow-unassociated-targets \
--schedule "cron(0 16 ? * TUE *)" \
--schedule-timezone "America/Los_Angeles" \
--start-date 2021-01-01T00:00:00-08:00 \
--end-date 2021-06-30T00:00:00-08:00 \
--duration 4 \
--cutoff 1
```
```
aws ssm create-maintenance-window \
--name "My-Rate-Maintenance-Window" \
--allow-unassociated-targets \
--schedule "rate(7 days)" \
--duration 4 \
--schedule-timezone "America/Los_Angeles" \
--cutoff 1
```
```
aws ssm create-maintenance-window \
--name "My-TimeStamp-Maintenance-Window" \
--allow-unassociated-targets \
--schedule "at(2021-07-07T13:15:30)" \
--duration 4 \
--schedule-timezone "America/Los_Angeles" \
--cutoff 1
```
**Mais informações**
[Expressão CRON](https://en.wikipedia.org/wiki/Cron#CRON_expression), no *Site da Wikipedia*