メニュー
Amazon CloudWatch Events
ユーザーガイド

ルールのスケジュール式の構文

cron または rate 式を使用して、CloudWatch イベント でスケジュールに基づいて自己トリガーするルールを作成できます。すべてのスケジュールされたイベントは UTC タイムゾーンを使用し、スケジュールの最小精度は 1 分です。

注記

CloudWatch イベント は、スケジュール式で第 2 レベルの精度を提供しません。Cron 式を使用した最小の解決は分です。CloudWatch イベント とターゲットサービスが持つ分散性の特質により、スケジュールされたルールがトリガーされてから、ターゲットサービスがターゲットリソースの実行を優先するまでの遅延は、数秒となる可能性があります。スケジュールされたルールは、その分のうちにトリガーされますが、正確に 0 秒にトリガーされません。

CloudWatch イベント では、以下の形式がサポートされています。

  • cron(<Fields>)

  • rate(<Value> <Unit>)

cron 式

cron 式は 6 つの必須フィールドがあります。フィールドは空白で区切ります。cron 式の詳細については、Wikipedia ウェブサイトの、「CRON 式」を参照してください。

フィールド ワイルドカード

0-59

, - * /

時間

0-23

, - * /

1-31

, - * ? / L W

1-12 または JAN-DEC

, - * /

曜日

1-7 または SUN-SAT

, - * ? / L

製造年

1970-2199

, - * /

注記

cron 式の Day-of-month フィールドおよび Day-of-week フィールドに同じ 値を指定することはできません。 一方のフィールドに値を指定すると、もう一方のフィールドで ? (疑問符) を使用する必要があります。

ワイルドカード:

ワイルドカード , (カンマ) には追加の値が含まれます。 月フィールドの、「JAN,FEB,MAR」は、1 月、2 月、3 月を含みます。

ワイルドカード - (ダッシュ) は範囲を指定します。 日フィールドの、「1-15」は、指定した月の 1 日から 15 日を含みます。

ワイルドカード * (アスタリスク) にはフィールドのすべての値が含まれます。 時間フィールドの、* にはすべての時間が含まれています。

ワイルドカード / (スラッシュ) で増分を指定します。 分フィールドで、「1/10」と入力して、その時間の最初の分から始めて、10 分毎を指定できます (11 分、21 分、31 分など)。

? (疑問符) ワイルドカードは任意を意味します。 Day-of-month フィールドで 7 と入力し、7 日が何曜日であってもかまわない場合、Day-of-week フィールドに ? を入力します。

Day-of-month フィールドまたは Day-of-week フィールドの、ワイルドカード L は月または週の最終日を指定します。

Day-of-month フィールドの、ワイルドカード W は、平日を指定します。 Day-of-month フィールドで、「3W」は月の 3 番目の平日に最も近い日を指定します。

スケジュールに基づいたルールを作成するときは、以下のサンプルの cron 文字列を使用できます。

注記

1 分より短い間隔を導き出す cron 式はサポートされていません。曜日と日の値の両方を指定はまだサポートされていません(現時点では「?」文字をこれらのフィールドのいずれかで使用する必要があります)。

時間 曜日 意味

0

10

*

*

?

*

毎日午前 10:00(UTC)に実行

15

12

*

*

?

*

毎日午後 12:15 (UTC) に実行

0

18

?

*

MON-FRI

*

毎週月曜日から金曜日まで午後 6:00 (UTC) に実行

0

8

1

*

?

*

毎月 1 日の午前 8:00(UTC)に実行

0/15

*

*

*

?

*

15 分ごとに実行

0/10

*

?

*

MON-FRI

*

月曜日から金曜日まで 10 分ごとに実行

0/5

8-17

?

*

MON-FRI

*

月曜日から金曜日まで午前 8:00 から午後 5:55(UTC)の間に 5 分ごとに実行

以下の例に示しているのは、AWS CLI で cron 式を使用する方法です。

Copy
aws events put-rule --schedule-expression 'cron(0 12 * * ? *)' --name MyRule1
Copy
aws events put-rule --schedule-expression 'cron(15 10 ? * 6L 2002-2005)' --name MyRule2

rate 式

rate 式には以下の 2 つの必須フィールドがあります。フィールドは空白で区切ります。

フィールド

正数

単位

分、時間、または日

注記

値が 1 に等しい場合、単位は単数形であることが必要です。同様に、1 より大きい値の場合、単位は複数であることが必要です。たとえば、rate(1 hours) と rate(5 hour) は有効ではありませんが、rate(1 hour) と rate(5 hours) は有効です。

以下の例に示しているのは、AWS CLI で rate 式を使用する方法です。

Copy
aws events put-rule --schedule-expression rate(5 minutes)' --name MyRule3
Copy
aws events put-rule --schedule-expression rate(1 hour)' --name MyRule4
Copy
aws events put-rule --schedule-expression rate(1 day)' --name MyRule5

このページの内容: