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.

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:

Associações comportam expressões do cron que incluem um dia da semana e o sinal numérico (#) 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.

Veja alguns exemplos de associações com rate.

Exemplos da AWS CLI 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.

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.

A tabela a seguir fornece exemplos de rate para janelas de manutenção.

Exemplos de AWS CLI 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