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 (Dia do mês) e Day-of-week (Dia da semana) 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. No campo Day-of-month (Dia do mês), se você inserir 7 e for indiferente a qual dia da semana é o 7º, poderá inserir ? no campo Day-of-week (Dia da semana).
-
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 campoYear
.
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 |
---|---|
|
Executada às 10h (UTC) todos os dias |
|
Executada às 12h15 (UTC) todos os dias |
|
Executada às 18h (UTC) de segunda a sexta |
|
Executar às 8h (UTC) no primeiro dia de cada mês |
|
Executar a cada 10 minutos de segunda a sábado de cada semana |
|
Executada a cada cinco minutos, de segunda-feira a sexta-feira, entre 8h e 17h55 (UTC) |