翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
cron 式と rate 式を使用して Amazon のルールをスケジュールする EventBridge
でスケジュールされたルールを作成する EventBridge ときに、 がルール EventBridge を実行するタイミングを決定するスケジュールパターンを指定できます。
cron 式を使用して、特定の日時でルールを実行します。
rate 式を使用して、ルールを一定の間隔で実行します。
cron 式
cron 式には 6 つの必須フィールドがあり、それらは空白で区切られます。
[Syntax (構文)]
cron(fields)
フィールド | 値 | ワイルドカード |
---|---|---|
分 |
0-59 |
, - * / |
時間 |
0-23 |
, - * / |
Day-of-month |
1-31 |
, - * ? / L W |
月 |
1~12 または JAN-DEC |
, - * / |
Day-of-week |
1~7 または SUN-SAT |
, - * ? L # |
年 |
1970-2199 |
, - * / |
ワイルドカード
-
, (カンマ) のワイルドカードには、追加の値が含まれます。月フィールドでは、 には 1 月JANFEB、MAR2 月、3 月が含まれます。
-
- (ダッシュ) のワイルドカードは、範囲を指定します。日フィールドの「1-15」は、指定した月の 1 日から 15 日を含みます。
-
[*] (アスタリスク) のワイルドカードには、フィールドのすべての値が含まれます。[時間] フィールドの * には すべての時間が含まれます。D フィールドay-of-month と D ay-of-week フィールドの両方で * を使用することはできません。一方に使用する場合は、もう一方に [?] を使用する必要があります。
-
[/] (スラッシュ) ワイルドカードで増分を指定します。分フィールドで、「1/10」と入力して、その時間の最初の分から始めて、10 分毎を指定できます (11 分、21 分、31 分など)。
-
? (疑問符) ワイルドカードは任意を意味します。D ay-of-month フィールドに 7 と入力し、曜日が許容できる場合は、Day-of-week フィールドに ? と入力できます。
-
D ay-of-month または D ay-of-week フィールドの L ワイルドカードは、月または週の最終日を指定します。
-
D ay-of-month フィールドの
W
ワイルドカードは平日を指定します。D ay-of-month フィールドで、月の 3 日目に最も近い曜日3W
を指定します。 -
D ay-of-week フィールドの # ワイルドカードは、1 か月内の指定された曜日の特定のインスタンスを指定します。例えば、3#2 は、月の第 2 火曜日を示します。3 は週の 3 番目の日 (火曜日) を示し、2 は月のそのタイプの 2 番目の日を示します。
注記
「#」文字を使用する場合は、 day-of-week フィールドで定義できる式は 1 つだけです。例えば、
"3#1,6#3"
は 2 つの式として解釈されるため、無効です。
制限事項
-
同じ cron 式で D フィールドay-of-month と D ay-of-week フィールドを指定することはできません。一方のフィールドに値または * (アスタリスク) を指定する場合、もう一方のフィールドで ? (疑問符) を使用する必要があります。
-
1 分より短い間隔を導き出す cron 式はサポートされていません。
例
スケジュールに基づいたルールを作成するときは、以下のサンプルの cron 文字列を使用できます。
分 | 時間 | 日 | 月 | 曜日 | 年 | 意味 |
---|---|---|---|---|---|---|
0 |
10 |
* |
* |
? |
* |
毎日午前 10:00 (UTC+0) に実行 |
15 |
12 |
* |
* |
? |
* |
毎日午後 12:15 (UTC+0) に実行 |
0 |
18 |
? |
* |
MON-FRI |
* |
毎週月曜日から金曜日まで午後 6:00 (UTC+0) に実行 |
0 |
8 |
1 |
* |
? |
* |
毎月 1 日午前 8:00 (UTC+0) に実行 |
0/15 |
* |
* |
* |
? |
* |
15 分ごとに実行 |
0/10 |
* |
? |
* |
MON-FRI |
* |
月曜日から金曜日まで 10 分ごとに実行 |
0/5 |
8-17 |
? |
* |
MON-FRI |
* |
月曜日から金曜日の午前 8 時から午後 5 時 55 分 (UTC+0) まで 5 分ごとに実行 |
0/30 |
20-2 |
? |
* |
MON-FRI |
* |
月曜日から金曜日まで、開始日の午後 10 時から翌日の午前 2 時まで 30 分ごとに実行 (UTC) 月曜日の午前 12 時から午前 2 時 () に実行しますUTC。 |
次の例では、毎日午後 12:00 UTC+0 に実行されるルールを作成します。
aws events put-rule --schedule-expression "cron(0 12 * * ? *)" --name
MyRule1
次の例では、毎日午後 2 時 5 分と午後 2 時 35 分 UTC+0 に実行されるルールを作成します。
aws events put-rule --schedule-expression "cron(5,35 14 * * ? *)" --name
MyRule2
次の例では、2019 年から 2022 年までの毎月の最終金曜日の午前 10:15 UTC+0 に実行されるルールを作成します。
aws events put-rule --schedule-expression "cron(15 10 ? * 6L 2019-2022)" --name
MyRule3
rate 式
rate 式は、予定されたイベントルールを作成すると開始され、その定義済みのスケジュールに基づいて実行されます。
rate 式には 2 つの必須フィールドがあり、空白で区切られます。
構文
rate(value unit)
- value
-
正数。
- 単位
-
時刻の単位。値 1 には、
minute
などさまざまな単位が必要です。また、1 を超える値にはminutes
などの単位が必要です。有効な値: minute | minutes | hour | hours | day | days
制限事項
値が 1 に等しい場合、単位は単数形であることが必要です。値が 1 より大きい場合、単位は複数であることが必要です。たとえば、rate(1 hours) と rate(5 hour) は有効ではありませんが、rate(1 hour) と rate(5 hours) は有効です。
例
次の例は、 put-rule
コマンドで AWS CLI rate 式を使用する方法を示しています。最初の例では、ルールを毎分起動し、次の例は 5 分ごとにルールを起動し、3 番目の例は 1 時間に 1 回ルールを起動し、最後の例は 1 日に 1 回ルールを起動します。
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