

# Agendamento de execuções do canário usando cron
<a name="CloudWatch_Synthetics_Canaries_cron"></a>

Usar uma expressão cron lhe dá flexibilidade quando você programa um canário. As expressões cron contêm cinco ou seis campos na ordem listada na tabela a seguir. Os campos são separados por espaços. A sintaxe será diferente se você usar o console do CloudWatch para criar o canário, a AWS CLI ou SDKs da AWS. Ao usar o console, especifique apenas os cinco primeiros campos. Usando a AWS CLI ou os SDKs da AWS, especifique todos os seis campos, e você deverá especificar `*` para o campo `Year`.


|  **Campo**  |  **Valores permitidos**  |  **Caracteres especiais permitidos**  | 
| --- | --- | --- | 
|  minutos  |  0-59  |  , - \$1 /  | 
|  Horas  |  0-23  |  , - \$1 /  | 
|  Dia do mês  |  1-31  |  , - \$1 ? / L W  | 
|  Mês  |  1-12 ou JAN-DEZ  |  , - \$1 /  | 
|  Dia da semana  |  1-7 ou DOM-SÁB  |  , - \$1 ? L \$1  | 
|  Ano  |  \$1  |    | 

**Caracteres especiais**
+ A **,**(vírgula) inclui vários valores na expressão de um campo. Por exemplo, no campo Month (Mês), JAN,FEB,MAR incluiria janeiro, fevereiro e março.
+ O caractere especial **-**(traço) especifica faixas. No campo Dia, 1-15 incluiria dias 1 a 15 do mês especificado.
+ O caractere especial **\$1** (asterisco) inclui todos os valores no campo. No campo Hours (Horas), **\$1** inclui todas as horas. Não é possível usar **\$1** nos campos Day-of-month e Day-of-week na mesma expressão. Se você usá-lo em um deles, utilize **?** no outro.
+ A **/** (barra) especifica incrementos. No campo Minutes (Minutos), é possível inserir 1/10 para especificar cada décimo minuto a partir do primeiro minuto da hora (por exemplo, o 11.º, 21.º e 31.º minuto etc.).
+ O **?** (ponto de interrogação) especifica um ou outro. Se você inserir **7** no campo Day-of-month e o dia da semana correspondente for irrelevante, é possível inserir **?** no campo Day-of-week.
+ O curinga **L** nos campos Dia do mês ou Dia da semana especifica o último dia do mês ou da semana.
+ O curinga **W** no campo Dia do mês especifica um dia da semana. No campo Dia do mês, **3W** especifica o dia mais próximo do terceiro dia da semana do mês.
+ O curinga **\$1** no campo Dia da semana especifica uma determinada instância do dia da semana definido dentro de um mês. Por exemplo, 3\$12 é a segunda terça-feira do mês. O 3 refere-se a terça-feira, porque é o terceiro dia de cada semana, e o 2 refere-se ao segundo dia desse tipo dentro do mês.

**Limitações**
+ Você não pode especificar os campos Dia do mês e Dia da semana na mesma expressão cron. Se você especificar um valor ou `*` (asterisco) em um dos campos, deverá usar **?** (ponto de interrogação) no outro.
+ Não há suporte para expressões Cron que causam taxas mais rápidas que um minuto.
+ Não é possível configurar um canário para esperar mais de um ano para ser executado. Portanto, você pode especificar apenas `*` no campo `Year`.

**Exemplos**  
Você pode consultar as seguintes sequências de caracteres cron de exemplo ao criar um canário. Os exemplos a seguir são a sintaxe correta para usar a AWS CLI ou os SDKs da AWS para criar ou atualizar um canário. Caso esteja usando o console do CloudWatch, omita a `*` final em cada exemplo.


| Expressão | Significado | 
| --- | --- | 
|   `0 10 * * ? *`   |  Executada às 10h (UTC) todos os dias  | 
|   `15 12 * * ? *`   |  Executada às 12h15 (UTC) todos os dias  | 
|   `0 18 ? * MON-FRI *`   |  Executada às 18h (UTC) de segunda a sexta  | 
|   `0 8 1 * ? *`   |  Executar às 8h (UTC) no primeiro dia de cada mês  | 
|   `0/10 * ? * MON-SAT *`   |  Executar a cada 10 minutos de segunda a sábado de cada semana  | 
|   `0/5 8-17 ? * MON-FRI *`   |  Executada a cada cinco minutos, de segunda-feira a sexta-feira, entre 8h e 17h55 (UTC)   | 