Amazon EventBridge でのルールの作成 - Amazon EventBridge

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon EventBridge でのルールの作成

前提条件

開始する前に、以下を確認してください。

  • Amazon EventBridge コンソールへのアクセス

  • EventBridge ルールを作成するための適切な IAM アクセス許可

  • イベント駆動型アーキテクチャの基本的な理解

概要:

EventBridge が受信したイベントに対してアクションを実行するには、ルールを作成できます。イベントがルールで定義されたイベントパターンと一致すると、EventBridge は指定されたターゲットにイベントを送信します。

このトピックでは、指定したイベントバスに送信されるイベントを EventBridge が一致させるために使用するルールを作成する方法について説明します。

EventBridge ルールの作成には、主に 4 つのステップがあります。

  1. 処理するイベントを選択する

  2. イベントフィルタリングとテストを設定する

  3. ターゲットの選択と設定

  4. ルール設定を構成する

イベントを選択する

まず、ターゲットに送信するイベントを選択します。

イベントを選択するには
  1. Amazon EventBridge コンソール のhttps://console.aws.amazon.com/events/ を開いてください。

  2. ナビゲーションペインで、ルールを選択し、ルールの作成を選択します。

  3. Events タブで、ターゲットに送信するイベントを見つけます。

    1. AWS サービスイベントまたはカスタムイベントを選択します。

    2. 検索ボックスを使用するか、イベントリストを参照して、ターゲットに送信するイベントを見つけます。

    3. 1 つ以上のイベントをビルドキャンバスにドラッグし、トリガーイベントにドロップします

    EventBridge にトリガーイベントセクションが表示されます。このセクションには以下が含まれます。

    • 選択したイベントを一覧表示するイベント。

    • スキーマ。使用可能な場合は、選択したイベントのスキーマを表示します。

      スキーマには 3 つのタブがあります。

      • ツリー: イベントスキーマのツリービュー。

      • コード: Open API 仕様または JSON 形式のイベントスキーマ。

      • 情報: スキーマの概要情報。

    • サンプルイベント。使用可能な場合は、選択したイベントのサンプルを表示します。

    • 選択したすべてのイベントを選択するイベントパターンを含むイベントパターン (フィルタ)

必要なもののみを送信するようにイベントをフィルタリングする

通常、特定のタイプのすべてのイベントをターゲットに送信する必要はありません。イベントパターンをより具体的にすることで、関心のある属性と値を含むイベントのみを選択できます。

イベントパターンを編集する (オプション)

トリガーイベントペインでは、次の 2 つの方法でイベントパターンを構築できます。

  • スキーマツリービューを使用して視覚的に表示

  • イベントパターンペインで JSON を直接編集する

スキーマツリービューを使用してイベントパターンを編集するには
  1. スキーマペインのツリータブを選択します。

  2. フィルターを追加および編集して、イベントパターンを構築します。

    1. イベントパターンにフィルターとして追加する属性の横にあるフィルターアイコンを選択します。

    2. ドロップダウンリストから比較演算子を選択します。

      比較演算子の詳細については、「イベントパターンの作成」を参照してください。

    3. 一致させる値を入力します。

    4. 完了するには、チェックマークをクリックします。

    EventBridge は、作成したフィルターをイベントパターンペインの JSON に追加します。

  3. 必要なすべてのイベント属性に一致するイベントパターンを構築するまで、フィルターを追加します。

イベントパターンをテストする

必要なすべてのイベント属性に一致するイベントパターンを構築したら、イベントパターンが期待どおりに動作することをテストします。

イベントパターンをテストする (オプション)

  1. テスト用のサンプルイベントを選択するか、独自のイベントを使用します。

    • 提供されたサンプルイベントを使用する

      1. 提供されたサンプルイベントを使用する を選択します。

      2. サンプルトリガーイベントで、ドロップダウンリストからテストに使用するイベントを選択します。

    • 独自のイベントを使用する

      1. 独自のイベントを使用するを選択します。

        EventBridge は、空の details 要素を持つ汎用イベントを表示します。

      2. イベント JSON を編集して、イベントパターンをテストするイベントを作成します。

        ヒント

        テストで使用する独自のカスタムイベントを作成するための開始点として提供されるサンプルイベントを使用できます。

        1. 提供されたサンプルイベントを使用を選択し、サンプルトリガーイベントからイベントを選択し、コピーを選択します。

        2. 独自のイベントを使用する を選択します。

        3. ウィンドウでイベント全体を選択し、サンプルイベントを貼り付けます。

        4. 必要に応じてイベントを編集します。

  2. テストの実行 を選択します。

    EventBridge は、テストイベントがイベントパターンと一致するかどうかを示すメッセージを表示します。

ターゲットを選択する

1 つ (および最大 5 つ) のターゲットをビルドキャンバスにドラッグし、ターゲットにドロップして、指定されたイベントパターンに一致するイベントを受信します。ターゲットには以下が含まれます。

  • 同じまたは別の EventBridge イベントバス AWS アカウント

  • Salesforce などの SaaS パートナーを含む EventBridge API の送信先

  • Amazon SQS キューや Amazon SNS トピックなど、さまざまな AWS サービスリソース

ターゲットを選択するには
  1. ターゲットペインからターゲットタイプを選択し、ビルドキャンバスのターゲットシェイプにドロップします。

    EventBridge は、ビルドのターゲットセクションを表示し、選択したターゲットのタイプに基づいて該当する設定オプションを表示します。

    ヒント

    複数のターゲットを指定した場合、ターゲットシェイプを選択すると、そのターゲットの設定セクションが表示されます。

  2. ターゲットタイプに基づいてターゲットを設定します。詳細な設定手順については、EventBridge ターゲット」を参照してください。

ターゲットに送信されるイベントデータをカスタマイズする

EventBridge イベントバスまたは EventBridge API 送信先以外のターゲットを選択した場合は、ターゲットに実際に配信されるデータをカスタマイズできます。

送信されたイベントデータを変換または置き換える (オプション)

  1. ビルドデザインキャンバスで、ターゲットシェイプの入力変換アイコンを選択します。

    EventBridge は入力変換セクションを表示します。

  2. 入力変換設定で、有効化 を選択します。

  3. 変換方法を選択して、一致するイベントのターゲットに送信されるテキストをカスタマイズする方法を選択します。

    • 一致したイベントの一部 — EventBridge は、元のソースイベントの指定された部分のみをターゲットに送信します。

    • 定数 (JSON テキスト) — EventBridge は指定された JSON テキストのみをターゲットに送信します。元のソースイベントは、いずれの部分も送信されません。

    • 入力トランスフォーマー – EventBridge がターゲットに送信するテキストをカスタマイズするように入力トランスフォーマーを設定します。詳細については、「ターゲット入力の変換」を参照してください。

ルールを設定する

最後に、ルールを設定して作成します。

ルールを設定するには (コンソール)
  1. [設定] を選択します。

  2. ルールの名前を入力し、オプションで説明を入力します。

    ルールは、同じ AWS リージョン および同じイベントバスの別のルールと同じ名前にすることはできません。

  3. [Event bus] (イベントバス) で、このルールに関連付けるイベントバスを選択します。

    このルールをアカウントからのイベントと一致させるには、AWS のデフォルトのイベントバスを選択します。 AWS のサービス アカウントの がイベントを送信すると、常にアカウントのデフォルトのイベントバスに送信されます。

  4. ルールが作成されるとすぐに有効にするには、アクティベーションアクティブを有効にします。

  5. (オプション) ルールに 1 つ以上のタグを入力します。詳細については、「Amazon EventBridge でのリソースのタグ付け」を参照してください。

  6. [作成] を選択します。

次の手順

ルールを作成したら、次のことができます。

その他のリソース

EventBridge ルールの詳細については、以下を参照してください。