Riferimento: espressioni Cron e Rate per Systems Manager

Quando crei un'associazione State Manager o una finestra di manutenzione in AWS Systems Manager, devi specificare una pianificazione per l'esecuzione della finestra o dell'associazione. Una pianificazione può essere specificata come elemento basato sul tempo, denominato espressione Cron, oppure come elemento basato sulla frequenza, denominato espressione Rate.

Informazioni generali sulle espressioni Cron e Rate

Le seguenti informazioni si applicano alle espressioni cron e rate sia per le finestre di manutenzione che per le associazioni.

Espressioni Cron e Rate per le associazioni

Questa sezione include esempi di espressioni Cron e Rate per le associazioni State Manager. Prima di creare una di tali espressioni, devi conoscere le seguenti informazioni:

Le associazioni supportano espressioni cron che includono un giorno della settimana e il segno numerico (#) per designare il n giorno di un mese per gestire un'associazione. Ecco un esempio che esegue un programma cron il terzo martedì di ogni mese alle 23:30 UTC:

cron(30 23 ? * TUE#3 *)

Ecco un esempio che viene eseguito il secondo giovedì di ogni mese a mezzanotte UTC:

cron(0 0 ? * THU#2 *)

Le associazioni supportano anche il segno (L) per indicare l'ultimo X giorno del mese. Ecco un esempio che esegue un programma cron l'ultimo martedì di ogni mese a mezzanotte UTC:

cron(0 0 ? * 3L *)

Per controllare ulteriormente l'esecuzione di un'associazione, ad esempio se si desidera eseguire un'associazione due giorni dopo la patch di martedì, è possibile specificare un offset. Un record offset definisce quanti giorni attendere dopo il giorno programmato per eseguire un'associazione. Ad esempio, se hai specificato un programma cron di cron(0 0 ? * THU#2 *), è possibile specificare il numero 3 nel campo Offset di pianificazione per eseguire l'associazione ogni domenica dopo il secondo giovedì del mese.

Per utilizzare gli offset, è necessario scegliere l'associazione Applica solo all'opzione successiva specificata Intervallo Cronopzione nella console o è necessario specificare l'uso del parametro --apply-only-at-cron-interval dalla riga di comando. Questa opzione dice a State Manager di non eseguire un'associazione immediatamente dopo la creazione.

La tabella seguente presenta esempi di espressioni cron per le associazioni.

Di seguito sono elencati alcuni esempi di espressioni Rate per le associazioni.

Esempi AWS CLI di espressioni per le associazioni

Per creare associazioni State Manager utilizzando AWS CLI, includi il parametro --schedule-expression con un'espressione Cron o Rate. Gli esempi seguenti usano AWS CLI su una macchina Linux locale.

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

Espressioni Cron e Rate per le finestre di manutenzione

Questa sezione include esempi di espressioni Cron e Rate per le finestre di manutenzione.

A differenza delle associazioni State Manager, le finestre di manutenzione supportano tutte le espressioni Cron e Rate. Ciò include il supporto per i valori nel campo dei secondi.

Ad esempio, la seguente espressione Cron composta da 6 campi esegue una finestra di manutenzione ogni giorno alle 9:30.

cron(30 09 ? * * *)

Aggiungendo un valore al campo Seconds, la seguente espressione Cron composta da 7 campi esegue una finestra di manutenzione ogni giorno alle 9:30:24.

cron(24 30 09 ? * * *)

La tabella seguente fornisce ulteriori esempi di espressioni Cron composte da 6 campi per le finestre di manutenzione.

La tabella seguente fornisce esempi di espressioni Rate per le finestre di manutenzione.

Esempi AWS CLI di espressioni per le finestre di manutenzione

Per creare delle finestre di manutenzione utilizzando la AWS CLI, includi il parametro --schedule con un'espressione Cron o Rate oppure un timestamp. Gli esempi seguenti usano AWS CLI su una macchina Linux locale.

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