Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Referenz: Cron- und Rate-Ausdrücke für System Manager
Wenn Sie eine erstellen State Manager In einer Zuordnung oder einem Wartungsfenster geben Sie einen Zeitplan an AWS Systems Manager, nach dem das Fenster oder die Zuordnung ausgeführt werden soll. Sie können einen Zeitplan als zeitbasierten Eintrag, einen sogenannten Cron-Ausdruck, oder als häufigkeitsbasierten Eintrag, einen sogenannten Rate-Ausdruck angeben.
Allgemeine Informationen zu Cron- und Rate-Ausdrücken
Die folgenden Informationen gelten für Cron- und Rate-Ausdrücke sowohl für Wartungsfenster als auch für Zuordnungen.
- Zeitpläne für Einzelläufe
-
Wenn Sie eine Zuordnung oder ein Wartungsfenster erstellen, können Sie einen Zeitstempel im Format Coordinated Universal Time (UTC) angeben, sodass das Programm einmal zur angegebenen Zeit ausgeführt wird. Zum Beispiel:
"at(2020-07-07T15:55:00)"
- Offsets planen
-
Assoziationen und Wartungsfenster unterstützen nur für Cron-Ausdrücke zudem auch Zeitplanversätze. Ein Zeitplanversatz ist die Anzahl der Tage, die nach dem über einen CRON-Ausdruck angegebenen Datum und der angegebenen Uhrzeit gewartet werden soll, bevor die Assoziation oder das Wartungsfenster ausgeführt wird.
Wenn Sie eine Zuordnung oder ein Wartungsfenster mit einem Cron-Ausdruck erstellen, das sich auf einen im aktuellen Zeitraum bereits vergangenen Tag bezieht, jedoch ein Zeitplanversatzdatum hinzufügen, das in der Zukunft liegt, wird die Assoziation oder das Wartungsfenster in dem betreffenden Zeitraum nicht ausgeführt. Es wird im folgenden Zeitraum in Kraft treten. Wenn Sie beispielsweise einen Cron-Ausdruck angeben, der gestern ein Wartungsfenster ausgeführt hätte, und einen Zeitplanversatz von zwei Tagen hinzufügen, wird das Wartungsfenster morgen nicht ausgeführt.
- Pflichtfelder
-
Cron-Ausdrücke für Wartungsfenster haben sechs erforderliche Felder. Cron-Ausdrücke für Assoziationen haben fünf. (State Manager unterstützt derzeit nicht die Angabe von Monaten in Cron-Ausdrücken für Assoziationen.) Ein zusätzliches Feld, das Feld
Seconds
(das erste in einem Cron-Ausdruck) ist optional. Die Felder werden durch Leerzeichen voneinander getrennt.Beispiele für Cron-Ausdrücke Minuten Stunden Tag des Monats Monat Wochentag Jahr Bedeutung 0 10 * * ? * Laufen Sie jeden Tag um 10:00 Uhr (UTC) 15 12 * * ? * Laufen Sie jeden Tag um 12:15 Uhr (UTC) 0 18 ? * MON-FRI * Läuft jeden Montag bis Freitag um 18:00 Uhr (UTC) 0 8 1 * ? * Läuft jeden ersten Tag des Monats um 8:00 Uhr (UTC) - Unterstützte Werte
-
Die folgende Tabelle zeigt die Werte, die für erforderliche Cron-Einträge unterstützt werden.
Unterstützte Werte für Cron-Ausdrücke Feld Werte Platzhalter Minuten 0
-59
, - * /
Stunden 0
-23
, - * /
D ay-of-month 1
-31
, - * ? / L W
Monat (nur Wartungsfenster) 1
–12
oderJAN
–DEC
, - * /
D ay-of-week 1
–7
oderSUN
–SAT
, - * ? / L #
Jahr 1970
-2199
, - * /
Anmerkung
Sie können keinen Wert in den Feldern day-of-month und in den day-of-week Feldern desselben Cron-Ausdrucks angeben. Wenn Sie einen Wert in einem der Felder angeben, verwenden Sie ? (Fragezeichen) im anderen Feld.
- Platzhalter für Cron-Ausdrücke
-
Die folgende Tabelle zeigt die Platzhalterwerte, die von Cron-Ausdrücken unterstützt werden.
Anmerkung
Cron-Ausdrücke, die zu schnelleren Häufigkeiten als fünf (5) führen, werden nicht unterstützt. Die Support für die Angabe von day-of-week sowohl einem day-of-month Wert als auch eines Werts ist nicht vollständig. Verwenden Sie das Fragezeichen (?) in einem dieser Felder.
Unterstützte Platzhalter für Cron-Ausdrücke Platzhalter Beschreibung , Das Platzhalterzeichen ,
(Komma) umfasst zusätzliche Werte. Im Feld Monat MAR würdeJAN,FEB, Januar, Februar und März enthalten.- 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./ Das Platzhalterzeichen /
(Schrägstrich) steht für schrittweise Steigerungen. Im Feld „Minuten“ könnten Sie 1/10 eingeben, um jede 10. Minute beginnend mit der ersten Minute der Stunde anzugeben. 1/10 gibt daher die erste, 11., 21., 31. usw. Minute an.? Das Platzhalterzeichen ?
(Fragezeichen) steht für einen bestimmten Wert. In das Day-of-month Feld könnten Sie 7 eingeben, und wenn es Ihnen egal ist, welcher Wochentag der 7. ist, könnten Sie eingeben? auf dem Day-of-week Feld.L Der L
Platzhalter in den Day-of-week Feldern Day-of-month oder gibt den letzten Tag des Monats oder der Woche an.W Der W
Platzhalter in dem Day-of-month Feld gibt einen Wochentag an. In dem Day-of-month Feld gibt 3W den Tag an, der dem dritten Wochentag des Monats am nächsten liegt.# Der #
Platzhalter in dem day-of-week Feld, gefolgt von einer Zahl zwischen eins und fünf, gibt einen bestimmten Tag des Monats an. 5 #3 gibt den 3. Donnerstag des Monats an. - Rate-Ausdrücke
-
Rate-Ausdrücke bestehen aus den folgenden zwei Pflichtfeldern. Felder werden durch Leerzeichen voneinander getrennt.
Pflichtfelder für Rate-Ausdrücke Feld Werte Wert
positive Zahl, z. B.
1
oder15
Einheit
minute
minutes
hour
hours
day
days
Wenn der Wert gleich
1
ist, muss die Einheit im Singular stehen. Wenn die Werte größer als1
sind, muss die Einheit im Plural stehen. Beispielsweise sindrate(1 hours)
undrate(5 hour)
ungültige,rate(1 hour)
undrate(5 hours)
jedoch gültige Werte.
Cron- und Rate-Ausdrücke für Zuordnungen
Dieser Abschnitt enthält Beispiele für Cron- und Rate-Ausdrücke für State Manager Assoziationen. Bevor Sie einen dieser Ausdrücke erstellen, beachten Sie die folgenden Informationen:
-
Zuordnungen unterstützen die folgenden Cron-Ausdrücke: Alle 1/2, 1, 2, 4, 8 oder 12 Stunden; jeden Tag, jede Woche oder jeden angegebenen Tag und jede bestimmte Uhrzeit der Woche; ein bestimmter Tag in einer bestimmten Woche des Monats oder der letzte
x
-Tag des Monats zu einer bestimmten Zeit. -
Zuordnungen unterstützen die folgenden Rate-Ausdrücke: Intervalle von mindestens 30 Minuten und weniger als 31 Tagen.
-
Wenn Sie das optionale Feld
Seconds
angeben, kann dessen Wert 0 (null) sein. Zum Beispiel:cron(0 */30 * * * ? *)
-
Für eine Zuordnung, die Metadaten für Inventory sammelt, eine Funktion von AWS Systems Manager, wird empfohlen, einen Rate-Ausdruck zu verwenden.
-
State Manager unterstützt derzeit nicht die Angabe von Monaten in Cron-Ausdrücken für Assoziationen.
Assoziationen unterstützen Cron-Ausdrücke, die einen Wochentag und das Zahlenzeichen (#) enthalten, um den x-ten Tag eines Monats für die Ausführung einer Assoziation anzugeben. Hier ist ein Beispiel, bei dem am dritten Dienstag im Monat um 23:30 Uhr ein Cron-Zeitplan ausgeführt wird: UTC
cron(30 23 ? * TUE#3 *)
Hier ist ein Beispiel, das jeden zweiten Donnerstag im Monat um Mitternacht läuft: UTC
cron(0 0 ? * THU#2 *)
Assoziationen unterstützen auch das (L)-Zeichen, um dens letzten XTag des Monats anzugeben. Hier ist ein Beispiel, das jeden letzten Dienstag im Monat um Mitternacht UTC einen Cron-Zeitplan ausführt:
cron(0 0 ? * 3L *)
Um weiter zu steuern, wann eine Assoziation ausgeführt wird, z. B. wenn Sie zwei Tage nach dem Patch-Dienstag eine Assoziation ausführen möchten, können Sie einen Offset angeben. Ein Offset definiert, wie viele Tage nach dem geplanten Tag gewartet werden müssen, um eine Assoziation auszuführen. Wenn Sie beispielsweise einen Cron-Zeitplan mit cron(0 0 ? *
THU#2 *)
angegeben haben, können Sie die Nummer 3 im Schedule offset (Planversatz)-Feld angeben, um die Assoziation jeden Sonntag nach dem zweiten Donnerstag im Monat auszuführen.
Um Offsets zu verwenden, müssen Sie entweder Apply association only at the next specified Cron interval (Übernehmen der Assoziation erst für das nächste angegebene Cron-Intervall)-Option in der Konsole auswählen oder Sie müssen den Nutze---apply-only-at-cron-interval
-Parameter über die Befehlszeile angeben. Diese Option sagt State Manager eine Assoziation nicht sofort auszuführen, nachdem Sie sie erstellt haben.
Die folgende Tabelle zeigt die Cron-Beispiele für Zuordnungen.
Beispiel | Details |
---|---|
cron(0/30 * * * ? *) |
Alle 30 Minuten |
cron(0 0/1 * * ? *) |
Stündlich |
cron(0 0/2 * * ? *) |
Alle 2 Stunden |
cron(0 0/4 * * ? *) |
Alle 4 Stunden |
cron(0 0/8 * * ? *) |
Alle 8 Stunden |
cron(0 0/12 * * ? *) |
Alle 12 Stunden |
cron(15 13 ? * * *) |
Täglich um 13:15 Uhr |
cron(15 13 ? * MON *) |
Jeden Montag um 13:15 Uhr |
cron(30 23 ? * TUE#3 *) |
Jeden dritten Dienstag im Monat um 23:30 Uhr |
Hier sind einige Rate-Beispiele für Zuordnungen.
Beispiel | Details |
---|---|
rate(30 minutes) |
Alle 30 Minuten |
rate(1 hour) |
Stündlich |
rate(5 hours) |
Alle 5 Stunden |
rate(15 days) |
Alle 15 Tage |
AWS CLI Beispiele für Assoziationen
Um zu erstellen State Manager Zuordnungen AWS CLI, die den verwenden, fügen Sie den --schedule-expression
Parameter mit einem Cron- oder Rate-Ausdruck hinzu. In den folgenden Beispielen wird der AWS CLI auf einem lokalen Linux-Computer verwendet.
Anmerkung
Wenn Sie eine neue Zuordnung erstellen, führt das System diese standardmäßig sofort nach der Erstellung und dann nach dem angegebenen Zeitplan aus. Geben Sie --apply-only-at-cron-interval
an, damit die Zuordnung nicht unmittelbar nach der Erstellung ausgeführt wird. Dieser Parameter wird nicht für Rate-Ausdrücke unterstützt.
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
Cron- und Rate-Ausdrücke für Wartungsfenster
Dieser Abschnitt enthält Beispiele für Cron- und Rate-Ausdrücke für Wartungsfenster.
Im Gegensatz zu State Manager Assoziationen und Wartungsfenster unterstützen alle Cron- und Rate-Ausdrücke. Dies umfasst die Unterstützung für Werte im Sekundenfeld.
Beispielsweise führt der folgende Cron-Ausdruck mit 6 Feldern jeden Tag um 9:30 Uhr ein Wartungsfenster aus.
cron(30 09 ? * * *)
Durch Hinzufügen eines Werts zum Feld Seconds
führt der folgende Cron-Ausdruck mit 7 Feldern jeden Tag um 9:30:24 Uhr ein Wartungsfenster aus.
cron(24 30 09 ? * * *)
Die folgende Tabelle enthält zusätzliche Beispiele für Cron-Ausdrücke mit 6 Feldern für Wartungsfenster.
Beispiel | Details |
---|---|
Cron (0) 2? * THU #3 *) |
02:00 Uhr jeden dritten Donnerstag im Monat |
cron(15 10 ? * * *) |
10:15 Uhr jeden Tag |
Krone (15 x 10? * MON - FRI *) |
10:15 Uhr jeden Montag, Dienstag, Mittwoch, Donnerstag und Freitag |
cron(0 2 L * ? *) |
02:00 Uhr jeden letzten Tag im Monat |
cron(15 10 ? * 6L *) |
10:15 Uhr jeden letzten Freitag im Monat |
Die folgende Tabelle enthält Beispiele für Raten von Wartungsfenstern.
Beispiel | Details |
---|---|
rate(30 minutes) |
Alle 30 Minuten |
rate(1 hour) |
Stündlich |
rate(5 hours) |
Alle 5 Stunden |
rate(25 days) |
Alle 25 Tage |
AWS CLI Beispiele für Wartungsfenster
Um Wartungsfenster mit dem zu erstellen AWS CLI, fügen Sie dem --schedule
Parameter einen Cron- oder Rate-Ausdruck oder einen Zeitstempel hinzu. In den folgenden Beispielen wird der AWS CLI auf einem lokalen Linux-Computer verwendet.
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
- Weitere Informationen
-
CRONAusdruck
auf der Wikipedia-Website