Utilizzo delle espressioni cron e rate per pianificare le regole in Amazon EventBridge - Amazon EventBridge

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo delle espressioni cron e rate per pianificare le regole in Amazon EventBridge

Quando si crea una regola pianificata in, EventBridge è possibile specificare uno schema di pianificazione che determina quando EventBridge viene eseguita la regola:

  • Usa un'espressione cron per eseguire la regola in orari e date specifici.

  • Usa un'espressione di frequenza per eseguire la regola a intervalli regolari.

Espressioni Cron

Le espressioni Cron hanno sei campi obbligatori separati da uno spazio vuoto.

Sintassi

cron(fields)
Campo Valori Caratteri jolly

Minuti

0-59

, - * /

Ore

0-23

, - * /

D ay-of-month

1-31

, - * ? / L W

Mese

1-12 o JAN - DEC

, - * /

D ay-of-week

1-7 o SUN - SAT

, - * ? L #

Anno

1970-2199

, - * /

Caratteri jolly
  • Il carattere jolly , (virgola) include valori aggiuntivi. Nel campo Mese,JAN,FEB, MAR include gennaio, febbraio e marzo.

  • Il carattere jolly - (trattino) specifica gli intervalli. Nel campo Day (Giorno), 1-15 include i primi 15 giorni del mese specificato.

  • Il carattere jolly * (asterisco) include tutti i valori nel campo. Nel campo Hours (Ore), * include ogni ora. Non puoi usare* in entrambi i ay-of-week campi D ay-of-month e D. Se viene utilizzato in uno di tali campi, è necessario utilizzare ? nell'altro.

  • Il carattere jolly / (barra) specifica gli incrementi. Nel campo Minutes (Minuti), puoi inserire 1/10 per specificare ogni decimo minuto, a partire dal primo minuto dell'ora (ad esempio, l'11°, il 21° e il 31° minuto e così via).

  • Il carattere jolly ? (punto interrogativo) specifica qualsiasi valore. Nel ay-of-month campo D puoi inserire 7 e se qualsiasi giorno della settimana fosse accettabile, potresti inserire? nel ay-of-week campo D.

  • Il carattere L nei ay-of-week campi D ay-of-month o D specifica l'ultimo giorno del mese o della settimana.

  • Il carattere W jolly nel ay-of-month campo D specifica un giorno della settimana. Nel ay-of-month campo D, 3W specifica il giorno della settimana più vicino al terzo giorno del mese.

  • Il carattere jolly # nel ay-of-week campo D specifica una determinata istanza del giorno della settimana specificato all'interno di un mese. Ad esempio, 3#2 sarebbe il secondo martedì del mese: il 3 fa riferimento a martedì perché è il terzo giorno di ogni settimana e il 2 fa riferimento al secondo giorno di questo tipo in un mese.

    Nota

    Se si utilizza un carattere '#', è possibile definire solo un'espressione nel day-of-week campo. Ad esempio, "3#1,6#3" non è valido perché viene interpretato come due espressioni.

Limitazioni
  • Non è possibile specificare i ay-of-week campi D ay-of-month e D nella stessa espressione cron. Se specifichi un valore o * (asterisco) in uno dei campi, devi usare un carattere ? (punto interrogativo) nell'altro campo.

  • Le espressioni Cron che indicano frequenze più rapide di 1 minuto non sono supportate.

Esempi

Quando crei una regola con pianificazione puoi utilizzare le seguenti stringhe Cron di esempio.

Minuti Ore Giorno del mese Mese Giorno della settimana Anno Significato

0

10

*

*

?

*

Corri alle 10:00 (UTC+0) ogni giorno

15

12

*

*

?

*

Corri alle 12:15 (UTC+0) ogni giorno

0

18

?

*

MON-FRI

*

Corri alle 18:00 (UTC+0) dal lunedì al venerdì

0

8

1

*

?

*

Esegui alle 8:00 (UTC+0) ogni primo giorno del mese

0/15

*

*

*

?

*

Esegui ogni 15 minuti

0/10

*

?

*

MON-FRI

*

Esegui dal lunedì al venerdì ogni 10 minuti

0/5

8-17

?

*

MON-FRI

*

Corri ogni 5 minuti dal lunedì al venerdì tra le 8:00 e le 17:55 (+0) UTC

0/30

20-2

?

*

MON-FRI

*

Corri ogni 30 minuti dal lunedì al venerdì dalle 22:00 del giorno di partenza alle 2:00 del giorno successivo () UTC

Corri dalle 12:00 alle 2:00 del lunedì mattina (). UTC

L'esempio seguente crea una regola che viene eseguita ogni giorno alle 12:00 +0. UTC

aws events put-rule --schedule-expression "cron(0 12 * * ? *)" --name MyRule1

L'esempio seguente crea una regola che viene eseguita ogni giorno, alle 14:05 e alle 14:35 +0. UTC

aws events put-rule --schedule-expression "cron(5,35 14 * * ? *)" --name MyRule2

L'esempio seguente crea una regola che viene eseguita alle 10:15 UTC +0 l'ultimo venerdì di ogni mese negli anni dal 2019 al 2022.

aws events put-rule --schedule-expression "cron(15 10 ? * 6L 2019-2022)" --name MyRule3

Espressioni della frequenza

Un'espressione della frequenza inizia quando crei la regola di evento pianificata e successivamente la esegui in base a una pianificazione definita.

Le espressioni della frequenza hanno due campi obbligatori separati da uno spazio vuoto.

Sintassi

rate(value unit)
value

Un numero positivo.

unità

L'unità di tempo. Per i valori di 1, ad esempio minute, e i valori maggiori di 1, ad esempio minutes, sono necessarie unità diverse.

Valori validi: minuto | minuti | ora | ore | giorno | giorni

Limitazioni

Se il valore è uguale a 1, l'unità deve essere al singolare. Se il valore è superiore a 1, l'unità deve essere al plurale. Ad esempio, rate(1 ore) e rate(5 ora) non sono valide, ma rate(1 ora) e rate(5 ore) sono valide.

Esempi

Negli esempi seguenti viene illustrato come utilizzare le espressioni di frequenza con il AWS CLI put-rule comando. Il primo esempio attiva la regola ogni minuto, quello successivo la attiva ogni cinque minuti, il terzo la attiva una volta all'ora e l'ultimo una volta al giorno.

aws events put-rule --schedule-expression "rate(1 minute)" --name MyRule2
aws events put-rule --schedule-expression "rate(5 minutes)" --name MyRule3
aws events put-rule --schedule-expression "rate(1 hour)" --name MyRule4
aws events put-rule --schedule-expression "rate(1 day)" --name MyRule5