はじめに
本記事では、EventBridgeでスケジュールルールを設定する際に使用するワイルドカードについて学んだ内容をまとめました。EventBridgeでスケジュールルールを作成する機会があり、どのようにすれば想定通りのスケジュールで実行されるルールを設定できるかを学んだので、その内容を整理しました。
ちなみに、作成したルールは1時間に3回実行する（毎時0分、20分、40分に実行する）ようなルールだったため、最初はrate式でやるかなと思ったんですが、最終的にはワイルドカードを使い、cron式で設定しました。
注意：EventBridgeで設定する時刻はUTCです。日本時間（JST）で想定した時刻に実行されるように値を設定してください。EventBrigdeでは設定したcron式が以後どのタイミングで実行されるか確認することができ、タイムゾーンもUTCとローカルタイムゾーンで切り替えることができるので、設定前にはそこで確認することをお勧めします。
前提知識
EventBridgeではスケジュールされたルールを作成するとき、ルールを実行するタイミングを設定する方法には以下の2つがあります。
- cron式
- rate式
cron式
イベントルールを実行したい時間や日時を定義します。
定義できる単位は、分 時間 日付 月 曜日 年で、この順番で指定します。
ワイルドカードを指定することで、定期実行されるルールを作成することもできます。AWSコンソールでは以下のような画面で設定できます。
rate式
イベントルールを実行したい間隔を定義します。
定義できる時間の単位は分、時間、日で、ルールを作成すると開始され、定義されたスケジュールに従って実行されます。AWSコンソールでは以下のような画面で設定できます。
cron式で使えるワイルドカード
制約事項
1つのcron式で日付と曜日の両方を指定することはできません。どちらかに何かしらの値を指定する場合は、もう片方は後述するワイルドカードの？を使う必要がある
*と？
*はフィールド内のすべての値が含まれます。また、?は任意の日付を指定するときに使用し、日付と曜日のフィールドでのみ使用できます。
例)毎時0分に実行されるルールを設定したいときのcron式
以下のどちらか（同じ意味）
分 時間 日付 月 曜日 年
0 * * * ? *
0 * ? * * *
,
,はフィールドに複数の値を選択できます。
例）AM10時とPM3時に実行されるルールを設定したいときのcron式
分 時間 日付 月 曜日 年
0 10,15 * * ? *
-
-はフィールドで範囲を指定することができます。
例）月曜日から金曜日までのAM10時とPM3時に実行されるルールを設定したいときのcron式
分 時間 日付 月 曜日 年
0 10,15 ? * MON-FRI *
/
/は増分の間隔を指定できます。曜日以外のフィールドで使用でき、開始のタイミングとその後どのぐらい間隔で実行するかを指定できる。
例）毎日10:00から11:00まで10分間隔で実行されるルールを設定したい時のcron式
分 時間 日付 月 曜日 年
0/10 10 ? * * *
ちなみに、増分される間隔(/の後の数字)として、設定するフィールドの周期の基本となる値（分の場合60、時間の場合24）を割り切れない値にすると、割り切れなかった分は実行されません。
例えば、以下のように1月の間だけ0時から11時間間隔で毎日実行されるルールを作った場合、実行されるタイミングは以下のようになります。
分 時間 日付 月 曜日 年
0 0/11 ? 1 * *
- 1/1 0:00
- 1/1 11:00
- 1/1 22:00
- 1/2 0:00（余った2時間はカットされる）
- 1/2 11:00
以下続く
L
Lは日付と曜日でのみ使用でき、日付で使用すると月の最終日、曜日で使用すると土曜日を指定する(SATと同じ)ことを表すcron式になります。
例）毎月の最終日の10時に実行されるルールを設定したいときのcron式
分 時間 日付 月 曜日 年
0 10 L * ? *
W
Wは日付でのみ使用できます。数字Wのように指定することで、指定した数字の日にちに最も近いweekday（月曜日から金曜日の間の曜日）を指定できます。指定した日が土曜日であれば前日の金曜日、指定した日が日曜日であれば翌日の月曜日を指定するcron式になります。
例）毎月最初の営業日の10時に実行されるルールを設定したいときのcron式
分 時間 日付 月 曜日 年
0 10 1W * ? *
#
#は曜日でのみ使用できる。数字#数字のように指定することで、その月の第◯曜日を指定できる
例）毎月第一月曜日の10時に実行されるルールを設定したいときのcron式
分 時間 日付 月 曜日 年
0 10 ? * 2#1 *
ちなみに◯#5を指定すると、第5週目にその曜日がある日付のみが指定され、その曜日の第5週目がない月はスキップされる。もちろん6以上は指定しても意味がないので注意。
0 10 ? * MON#5 *
0 10 ? * MON#6 *
参考