メニュー
Amazon EC2 Systems Manager
ユーザーガイド

Systems Manager の cron スケジュール

Systems Manager ステートマネージャーを使用して Systems Manager メインテナンスウィンドウまたは関連付けを作成する場合、ウィンドウ/関連付けを実行するタイミングのスケジュールを指定します。スケジュールを指定する形式として、時間ベースのエントリ (cron 式) または頻度ベースのエントリ (rate 式) のいずれかを使用できます。

例: この cron 式ではメンテナンスウィンドウまたは関連付けを毎週火曜日の午後 4 (16:00) 時に実行します: cron(0 16 ? * TUE *)

この式を AWS CLI で指定するには、次のように -- schedule パラメータを使います。

Copy
--schedule "cron(0 16 ? * TUE *)"

例: この rate 式ではメンテナンスウィンドウまたは関連付けを 1 日おきに実行します: rate(2 days)

この式を AWS CLI で指定するには、次のように -- schedule パラメータを使います。

Copy
--schedule "rate(2 days)"

cron 式は 6 つの必須フィールドがあります。フィールドは空白で区切ります。

時間 曜日 意味
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 分ごとに実行

次の表は、その他の cron 式の例です。

cron 式の例 実行時間

0 0 2 ? 1/1 THU#3 *

毎月第 3 木曜日の午前 02:00

0 15 10 ? * *

毎日午前 10:15

0 0 0 21 1/1 ? *

毎月 21 日の真夜中

0 15 10 ? * MON-FRI

毎週月〜金の午前 10:15

0 0 2 L * ?

毎月最終日の午前 02:00

0 15 10 ? * 6L

毎月の最終金曜日の午前 10:15

次の表は、サポートされている必須 cron エントリの値の一覧です。

フィールド ワイルドカード
0-59 , - * /
時間 0-23 , - * /
1-31 , - * ? / L W
1-12 または JAN-DEC , - * /
曜日 1-7 または SUN-SAT , - * ? / L
1970-2199 , - * /

注記

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

ワイルドカード

cron 式では、以下のワイルドカード文字がサポートされます。

  • ワイルドカード , (カンマ) には追加の値が含まれます。 月フィールドの、「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 番目の平日に最も近い日を指定します。

注記

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

cron 式の詳細については、「CRON expression」 (Wikipedia ウェブサイト) を参照してください。

rate 式

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

フィールド

正数

単位

分、時間、または日

注記

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