

# 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 | , - \* / | 
| Horas | 0-23 | , - \* / | 
| Dia do mês | 1-31 | , - \* ? / L W | 
| Mês | 1-12 ou JAN-DEZ | , - \* / | 
| Dia da semana | 1-7 ou DOM-SÁB | , - \* ? L \# | 
| Ano | \* |  | 

**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 **\*** (asterisco) inclui todos os valores no campo. No campo Hours (Horas), **\*** inclui todas as horas. Não é possível usar **\*** 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 **\#** no campo Dia da semana especifica uma determinada instância do dia da semana definido dentro de um mês. Por exemplo, 3\#2 é 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)  | 