Agendamento de execuções do canário usando cron - Amazon CloudWatch

Agendamento de execuções do canário usando cron

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 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)