Amazon ス EventBridge ケジューラ

Amazon EventBridge Scheduler はサーバーレススケジューラで、1 つの中央マネージドサービスからタスクを作成、実行、管理できます。ス EventBridge ケジューラを使用すると、繰り返しパターンの cron 式と rate 式を使用してスケジュールを作成したり、1 回限りの呼び出しを設定したりできます。配信の柔軟な時間枠を設定し、再試行制限を定義し、失敗したAPI呼び出しの最大保持時間を設定できます。

EventBridge スケジューラは高度にカスタマイズ可能で、スケジュールEventBridge されたルール よりもスケーラビリティが向上し、より広範なターゲットAPIオペレーションと AWS サービスを提供します。スケジュールに従ってターゲットを呼び出すには、ス EventBridge ケジューラを使用することをお勧めします。

実行ロールを設定する

新しいスケジュールを作成する場合、ス EventBridge ケジューラにはユーザーに代わってターゲットAPIオペレーションを呼び出すアクセス許可が必要です。これらのアクセス許可は、実行ロール を使用してス EventBridge ケジューラに付与します。スケジュールの実行ロールにアタッチするアクセス許可ポリシーによって、必要なアクセス許可が定義されます。これらのアクセス許可は、スケ EventBridge ジューラが呼びAPI出すターゲットによって異なります。

次の手順のように、ス EventBridge ケジューラコンソールを使用してスケジュールを作成すると、ス EventBridge ケジューラは選択したターゲットに基づいて実行ロールを自動的にセットアップします。ス EventBridge ケジューラ SDKs、、 AWS CLIまたは のいずれかを使用してスケジュールを作成する場合は AWS CloudFormation、ス EventBridge ケジューラがターゲットを呼び出すために必要なアクセス許可を付与する既存の実行ロールが必要です。スケジュールの実行ロールを手動で設定する方法の詳細については、スEventBridge ケジューラユーザーガイドの「実行ロールの設定」を参照してください。

新しいスケジュールを作成する

コンソールを使用してスケジュールを作成するには

1. ホーム で Amazon EventBridge Scheduler コンソールを開きます。 https://console.aws.amazon.com/scheduler/

2. [スケジュール] ページで、[スケジュールを作成] を選択します。

3. [スケジュールの詳細を指定] ページの [スケジュールの名前と説明] セクションで、次を実行します。

   1. [スケジュール名] で、スケジュールの名前を入力します。例えば、MyTestSchedule と指定します。

   2. (オプション) [説明] で、スケジュールの説明を入力します。例えば、My first schedule と指定します。

   3. [スケジュールグループ] で、ドロップダウンリストからスケジュールグループを選択します。グループがない場合は、[デフォルト] を選択します。スケジュールグループを作成するには、[独自のスケジュールを作成] を選択します。

      スケジュールグループを使用して、スケジュールのグループにタグを追加します。

4. 1. スケジュールオプションを選択します。

      頻度	手順
      [1 回限りのスケジュール] 1 回限りのスケジュールは、指定した日時に 1 回だけターゲットを呼び出します。	[日付と時刻] で、次を実行します。 有効な日付を YYYY/MM/DD 形式で入力します。 タイムスタンプを 24 時間 (hh:mm) 形式で入力します。 [タイムゾーン] で、タイムゾーンを選択します。
      [繰り返しのスケジュール] 繰り返しのスケジュールは、cron 式またはレート式を使用して指定したレートでターゲットを呼び出します。	[スケジュールの種類] では、次のいずれかを実行します。 Cron 式を使用してスケジュールを定義するには、[cron ベースのスケジュール] を選択して Cron 式を入力します。 Rate 式を使用してスケジュールを定義するには、[rate ベースのスケジュール] を選択して Rate 式を入力します。 cron 式と rate 式の詳細については、「Amazon Scheduler ユーザーガイド」の EventBridge 「Schedule types on Scheduler」を参照してください。 EventBridge [フレックスタイムウィンドウ] で、[オフ] を選択してオプションをオフにするか、事前定義された時間枠のいずれかを選択します。例えば、[15 分] を選択し、1 時間に 1 回ターゲットを呼び出す繰り返しのスケジュールを設定した場合、スケジュールは毎時の開始後 15 分以内に実行されます。

5. (オプション) 前のステップで [定期的なスケジュール] を選択した場合は、[時間枠] セクションで次を実行します。

   1. [タイムゾーン] で、タイムゾーンを選択します。

   2. [開始日時] で、有効な日付を YYYY/MM/DD 形式で入力してから、タイムスタンプを 24 時間 (hh:mm) 形式で指定します。

   3. [終了日時] で、有効な日付を YYYY/MM/DD 形式で入力してから、タイムスタンプを 24 時間 (hh:mm) 形式で指定します。

6. [Next (次へ)] を選択します。

7. ターゲットの選択ページで、ス EventBridge ケジューラが呼び出すオペレーションを選択します AWS API。

   1. ターゲット でAPI、テンプレート化されたターゲット を選択します。

   2. Amazon EventBridge PutEventsを選択します。

   3. でPutEvents、以下を指定します。

      • EventBridge イベントバス では、ドロップダウンメニューからイベントバスを選択します。例えば、default と指定します。

        新しいイベントバスの作成 を選択して、 EventBridge コンソールで新しいイベントバスを作成することもできます。

      • [詳細タイプ] に、一致させるイベントの詳細タイプを入力します。例えば、Object Created と指定します。

      • [ソース] に、イベントのソースとなるサービスの名前を入力します。

        AWS サービスイベントの場合は、ソースとしてサービスプレフィックスを指定します。aws. プレフィックスは含めないでください。例えば、Amazon S3 イベントの場合は、「s3」と入力します。

        サービスのプレフィックスを確認するには、「サービス認可リファレンス」の「条件キーテーブル」を参照してください。ソースと詳細タイプのイベント値について詳しくは、「AWS サービスイベントメタデータ」を参照してください。

      • （オプション): 詳細 にイベントパターンを入力して、ス EventBridge ケジューラが に送信するイベントをさらにフィルタリングします EventBridge。

        詳細については、「Amazon EventBridge イベントパターン」を参照してください。

8. [Next (次へ)] を選択します。

9. [Settings] (設定) ページで、以下の操作を行います。

   1. スケジュールをオンにするには、[スケジュールの状態] で [スケジュールを有効にする] をオンに切り替えます。

   2. スケジュールの再試行ポリシーを設定するには、「再試行ポリシーとデッドレターキュー (DLQ）」で、次の操作を行います。

      • [再試行] を切り替えてオンにします。

      • イベント の最大経過時間 には、ス EventBridge ケジューラが未処理のイベントを保持する必要がある最大時間 (s) と最小 (s) を入力します。

      • 最大 24 時間です。

      • 最大再試行回数 には、ターゲットがエラーを返した場合にス EventBridge ケジューラがスケジュールを再試行する最大回数を入力します。

        再試行の最大値は 185 です。

      再試行ポリシーでは、スケジュールがターゲットの呼び出しに失敗した場合、ス EventBridge ケジューラはスケジュールを再実行します。設定されている場合は、スケジュールの最大保持時間と再試行を設定する必要があります。

   3. ス EventBridge ケジューラが未配信イベントを保存する場所を選択します。

      デッドレターキュー (DLQ) オプション	手順
      保存しない	[None] を選択します。
      スケジュールを作成するのと同じ AWS アカウント にイベントを保存する	AWS アカウント として で Amazon SQSキューを選択 DLQを選択します。 Amazon SQSキューの Amazon リソースネーム (ARN) を選択します。
      スケジュールを作成する場所 AWS アカウント とは異なる にイベントを保存する	他の の Amazon SQSキューを AWS アカウント として指定 を選択しますDLQ。 Amazon SQSキューの Amazon リソースネーム (ARN) を入力します。

   4. カスタマーマネージドキーを使用してターゲットの入力を暗号化するには、[暗号化] で [暗号化設定をカスタマイズする (高度)] を選択します。

      このオプションを選択した場合は、既存のKMSキーを入力するARNか、 AWS KMS keyの作成 を選択して AWS KMS コンソールに移動します。ス EventBridge ケジューラが保管中のデータを暗号化する方法の詳細については、「Amazon EventBridge Scheduler ユーザーガイド」の「保管時の暗号化」を参照してください。

   5. ス EventBridge ケジューラに新しい実行ロールを作成させるには、このスケジュールの新しいロールを作成する を選択します。その後、[ロール名] で名前を入力します。このオプションを選択すると、ス EventBridge ケジューラはテンプレート化されたターゲットに必要なアクセス許可をロールにアタッチします。

10. [Next (次へ)] を選択します。

11. [スケジュールの確認と作成] ページで、スケジュールの詳細を確認します。各セクションで、そのステップに戻って詳細を編集するには、[編集] を選択します。

12. [スケジュールを作成] を選択します。

    [スケジュール] ページで、新規および既存のスケジュールのリストを表示できます。[ステータス] 列で、新しいスケジュールが [有効] になっていることを確認します。

関連リソース

ス EventBridge ケジューラの詳細については、以下を参照してください。

• EventBridge スケジューラユーザーガイド

• EventBridge スケジューラAPIリファレンス

• EventBridge スケジューラの料金