Verwendung von Cron- und Rate-Ausdrücken zur Planung von Regeln in Amazon EventBridge

Wenn Sie eine geplante Regel in erstellen, können EventBridge Sie ein Zeitplanmuster angeben, das bestimmt, wann die Regel EventBridge ausgeführt wird:

• Verwenden Sie einen Cron-Ausdruck, um die Regel zu bestimmten Zeiten und Daten auszuführen.

• Verwenden Sie einen Ratenausdruck, um die Regel in regelmäßigen Abständen auszuführen.

Cron-Ausdrücke

Cron-Ausdrücke verfügen über sechs Pflichtfelder, die durch Leerzeichen voneinander getrennt sind.

Syntax

cron(fields)

Feld	Werte	Platzhalter
Minuten	0-59	, - * /
Stunden	0-23	, - * /
D ay-of-month	1-31	, - * ? / L W
Monat	1-12 oder JAN - DEC	, - * /
D ay-of-week	1-7 oder SUN - SAT	, - * ? / L #
Jahr	1970-2199	, - * /

Platzhalter

• Das Platzhalterzeichen , (Komma) schließt zusätzliche Werte ein. Im Feld Monat MAR umfasstJAN,FEB, Januar, Februar und März.

• Das Platzhalterzeichen - (Bindestrich) gibt einen Bereich an. Im Feld Tag steht 1-15 für die Tage 1 bis 15 des angegebenen Monats.

• Das Platzhalterzeichen * (Sternchen) steht für alle Werte im Feld. Im Feld für die Stundenangaben steht * für alle Stunden. Sie können * nicht sowohl in den ay-of-week Feldern D als ay-of-month auch in D verwenden. Wenn Sie es in einem der Felder eingeben, müssen Sie im anderen Feld ein ? verwenden.

• Das Platzhalterzeichen / (Schrägstrich) steht für schrittweise Steigerungen. Im Feld "Minuten" können Sie 1/10 eingeben, um einen Bereich von je 10 Minuten beginnend mit der ersten Minute der Stunde anzugeben (z. B. die 11., 21. und 31. Minute usw.).

• Das Platzhalterzeichen ? (Fragezeichen) steht für einen beliebigen Wert. In das ay-of-month D-Feld könnten Sie 7 eingeben und wenn ein beliebiger Wochentag zulässig ist, könnten Sie eingeben? im ay-of-week D-Feld.

• Der Platzhalter L in den ay-of-week Feldern D ay-of-month oder D gibt den letzten Tag des Monats oder der Woche an.

• Der W Platzhalter im ay-of-month D-Feld gibt einen Wochentag an. 3WGibt im ay-of-month Feld D den Wochentag an, der dem dritten Tag des Monats am nächsten liegt.

• Der Platzhalter # im ay-of-week Feld D gibt eine bestimmte Instanz des angegebenen Wochentags innerhalb eines Monats an. Beispiel: 3#2 steht für den zweiten Dienstag des Monats: Die 3 bezieht sich auf Dienstag, da dies der dritte Tag jeder Woche ist, und die 2 bezieht sich auf den zweiten Tag dieses Typs innerhalb des Monats.

  Anmerkung

  Wenn Sie das Zeichen '#' verwenden, können Sie nur einen Ausdruck in dem day-of-week Feld definieren. Beispiel, "3#1,6#3" ist ungültig, da es als zwei Ausdrücke interpretiert wird.

Einschränkungen

• Sie können die ay-of-week Felder D ay-of-month und D nicht in demselben Cron-Ausdruck angeben. Wenn Sie in einem der Felder einen Wert oder ein * (Sternchen) angeben, müssen Sie ein ? (Fragezeichen) im anderen verwenden.

• Cron-Ausdrücke, die zu schnelleren Häufigkeiten als mit 1 Minute führen, werden nicht unterstützt.

Beispiele

Sie können die folgenden Beispiel-Cron-Zeichenfolgen beim Erstellen einer Regel mit Zeitplan verwenden.

Minuten	Stunden	Tag des Monats	Monat	Wochentag	Jahr	Bedeutung
0	10	*	*	?	*	Laufen Sie jeden Tag um 10:00 Uhr (UTC+0)
15	12	*	*	?	*	Laufen Sie jeden Tag um 12:15 Uhr (UTC+0)
0	18	?	*	MON-FRI	*	Läuft jeden Montag bis Freitag um 18:00 Uhr (UTC+0)
0	8	1	*	?	*	Läuft jeden ersten Tag des Monats um 8:00 Uhr (UTC+0)
0/15	*	*	*	?	*	Ausführung alle 15 Minuten
0/10	*	?	*	MON-FRI	*	Ausführung alle 10 Minuten von Montag bis Freitag
0/5	8-17	?	*	MON-FRI	*	Laufen Sie montags bis freitags alle 5 Minuten zwischen 8:00 Uhr und 17:55 Uhr (+0) UTC
0/30	20-2	?	*	MON-FRI	*	Laufen Sie montags bis freitags alle 30 Minuten zwischen 22:00 Uhr am Starttag und 2:00 Uhr am Folgetag () UTC Laufen Sie am Montagmorgen von 12:00 Uhr bis 2:00 Uhr ()UTC.

Im folgenden Beispiel wird eine Regel erstellt, die täglich um 12:00 Uhr UTC +0 ausgeführt wird.

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

Im folgenden Beispiel wird eine Regel erstellt, die täglich um 14:05 Uhr und 14:35 Uhr +0 ausgeführt wird. UTC

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

Im folgenden Beispiel wird eine Regel erstellt, die in den Jahren 2019 bis 2022 jeweils am letzten Freitag im Monat um 10:15 Uhr UTC +0 Uhr ausgeführt wird.

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

Rate-Ausdrücke

Ein Rate-Ausdruck beginnt, wenn Sie die Regel für geplante Ereignisse erstellen, und wird dann nach einem definierten Zeitplan ausgeführt.

Rate-Ausdrücke verfügen über zwei Pflichtfelder, die durch Leerzeichen voneinander getrennt sind.

Syntax

rate(value unit)

Wert

Eine positive Zahl.

Einheit

Die Zeiteinheit. Für Werte von 1 werden verschiedene Einheiten benötigt, z. B. minute, ebenso für Werte über 1, z. B. minutes.

Zulässige Werte: Minute | Minuten | Stunde | Stunden | Tag | Tage

Einschränkungen

Wenn der Wert gleich 1 ist, dann muss die Einheit im Singular stehen. Wenn der Wert größer als 1 ist, muss die Einheit im Plural sein. Beispiel: rate(1 Stunden) und rate(5 Stunde) sind nicht gültig, aber rate(1 Stunde) und rate(5 Stunden) sind gültig.

Beispiele

Die folgenden Beispiele zeigen, wie Ratenausdrücke mit dem AWS CLI put-rule Befehl verwendet werden. Das erste Beispiel löst die Regel einmal jede Minute aus, das zweite Beispiel einmal alle fünf Minuten, das dritte Beispiel einmal jede Stunde und das letzte Beispiel einmal jeden Tag.

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