EventBridge サンドボックスを使用したイベントパターンのテスト

イベントパターンの定義は、通常、新しいルールの作成や既存のルールの編集という、より大きなプロセスの一環として行います。ただし EventBridge、 でサンドボックスを使用すると、ルールを作成または編集しなくても、イベントパターンをすばやく定義し、サンプルイベントを使用してパターンが目的のイベントと一致することを確認できます。イベントパターンをテストしたら、サンドボックスから直接そのイベントパターンを使用して新しいルールを作成するオプション EventBridge を提供します。

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

重要

では EventBridge、 higher-than-expected 料金やスロットリングにつながる可能性のあるルールを作成できます。例えば、ルールが無限に再帰的に実行される無限ループに陥るようなルールを誤って作成してしまうことがあります。Amazon S3 バケットでACLs変更された を検出し、ソフトウェアをトリガーして目的の状態に変更するルールを作成したとします。ルールが慎重に記述されていない場合、後続の への変更によってルールが再度ACLs起動され、無限ループが作成されます。

このような予期しない結果を最小限に抑えるための正確なルールやイベントパターンを記述する方法に関するガイダンスについては、ルールのベストプラクティス および ベストプラクティス を参照してください。

EventBridge サンドボックスを使用してイベントパターンをテストするには

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

2. ナビゲーションペインで [デベロッパーリソース]、[サンドボックス] の順に選択し、[サンドボックス] ページで [イベントパターン] タブを選択します。

3. イベントソース で、AWS イベント または EventBridgeパートナーイベント を選択します。

4. [サンプルイベント] セクションで、イベントパターンをテストする対象の [サンプルイベントタイプ] を選択します。

   次のサンプルイベントタイプを使用できます｡

   • AWS events – サポートされている から出力されたイベントから選択します AWS サービス。

   • EventBridge パートナーイベント – Salesforce EventBridgeなどの をサポートするサードパーティーサービスから出力されるイベントから選択します。

   • 自分のイベントを入力 – 独自のイベントをJSONテキストで入力します。

     また、独自のカスタムイベントを作成するための出発点として AWS または パートナーイベントを使用することもできます。

     1. AWS イベントまたはEventBridge パートナーイベント を選択します。

     2. [サンプルイベント] ドロップダウンを使用して、カスタムイベントの開始点として使用するイベントを選択します。

        EventBridge にサンプルイベントが表示されます。

     3. [コピー] を選択します。

     4. [イベントタイプ] で [自分のイベントを入力] を選択します。

     5. JSON 編集ペインでサンプルイベント構造を削除し、代わりに AWS または パートナーイベントを貼り付けます。

     6. イベントを編集JSONして、独自のサンプルイベントを作成します。

5. [Creation method] (作成方法) を選択します。 EventBridge スキーマまたはテンプレートからイベントパターンを作成することも、カスタムイベントパターンを作成することもできます。

   Existing schema

   既存の EventBridge スキーマを使用してイベントパターンを作成するには、次の手順を実行します。

   1. [Creation method] (作成方法) セクションの [Method] (メソッド) で、[Use schema] (スキーマを使用) を選択します。

   2. [Event pattern] (イベントパターン) セクションの [Schema type] (スキーマタイプ) で、[Select schema from Schema registry] (スキーマレジストリからスキーマを選択) を選択します。

   3. [Schema registry] (スキーマレジストリ) では、ドロップダウンボックスを選択して、aws.events などのスキーマレジストリの名前を入力します。表示されるドロップダウンリストからオプションを選択することもできます。

   4. [Schema] (スキーマ) では、ドロップダウンボックスを選択して、使用するスキーマの名前を入力します。例えば aws.s3@ObjectDeleted です。表示されるドロップダウンリストからオプションを選択することもできます。

   5. [Models] (モデル) セクションでは、任意の属性の横にある [Edit] (編集) ボタンを選択してプロパティを開きます。必要に応じて [Relationship] (関係) フィールドと [Value] (値) フィールドを設定し、次に [Set] (設定) を選択して属性を保存します。

      注記

      属性の定義については、属性名の横にある[Info] (情報) アイコンを選択してください。イベントで属性のプロパティを設定する方法については、属性のプロパティダイアログボックスの [Note] (注意) セクションを開いてください。

      属性のプロパティを削除するには、その属性の [Edit] (編集) ボタンを選択し、[Clear] (クリア) を選択します。

   6. でイベントパターンを生成 JSON を選択して、イベントパターンをJSONテキストとして生成して検証します。

   7. テストパターンに対してサンプルイベントをテストするには、[テストパターン] を選択します。

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

      次のオプションのいずれかを選択することもできます。

      • [Copy] (コピー) — イベントパターンをデバイスのクリップボードにコピーします。

      • Prettify – 改行、タブ、スペースを追加することで、JSONテキストの読みやすさを実現します。

   Custom schema

   カスタムスキーマを記述し、それをイベントパターンに変換して、以下の操作を行います。

   1. [Creation method] (作成方法) セクションの [Method] (メソッド) で、[Use schema] (スキーマを使用) を選択します。

   2. [Event pattern] (イベントパターン) セクションで、[Schema type] (スキーマの種類) で、[Enter schema] (スキーマを入力) を選択します。

   3. テキストボックスにスキーマを入力します。スキーマを有効なJSONテキストとしてフォーマットする必要があります。

   4. [Models] (モデル) セクションでは、任意の属性の横にある [Edit] (編集) ボタンを選択してプロパティを開きます。必要に応じて [Relationship] (関係) フィールドと [Value] (値) フィールドを設定し、次に [Set] (設定) を選択して属性を保存します。

      注記

      属性の定義については、属性名の横にある[Info] (情報) アイコンを選択してください。イベントで属性のプロパティを設定する方法については、属性のプロパティダイアログボックスの [Note] (注意) セクションを開いてください。

      属性のプロパティを削除するには、その属性の [Edit] (編集) ボタンを選択し、[Clear] (クリア) を選択します。

   5. でイベントパターンを生成 JSON を選択して、イベントパターンをJSONテキストとして生成して検証します。

   6. テストパターンに対してサンプルイベントをテストするには、[テストパターン] を選択します。

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

      次のオプションのいずれかを選択することもできます。

      • [Copy] (コピー) — イベントパターンをデバイスのクリップボードにコピーします。

      • Prettify – 改行、タブ、スペースを追加することで、JSONテキストの読みやすさを実現します。

   Event pattern

   カスタムイベントパターンを JSON形式で書き込むには、次の手順を実行します。

   1. 「作成方法」セクションの「方法」で、「カスタムパターン (JSON エディタ）」を選択します。

   2. イベントパターン には、カスタムイベントパターンを JSON形式のテキストで入力します。

   3. テストパターンに対してサンプルイベントをテストするには、[テストパターン] を選択します。

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

      次のオプションのいずれかを選択することもできます。

      • [Copy] (コピー) — イベントパターンをデバイスのクリップボードにコピーします。

      • Prettify – 改行、タブ、スペースを追加することで、JSONテキストの読みやすくします。

      • [Event pattern form] (イベントパターンフォーム) — パターンビルダーでイベントパターンを開きます。Pattern Builder でパターンをそのままレンダリングできない場合、 は Pattern Builder を開く前に EventBridge 警告します。

6. (オプション) このイベントパターンを使用してルールを作成し、そのルールを特定のイベントバスに割り当てるには、[パターンを持つルールを作成] を選択します。

   EventBridge では、ルールの作成 のステップ 1 に進みます。これを使用してルールを作成し、選択したイベントバスに割り当てることができます。

   [ステップ 2 - イベントパターンを構築] には、既に指定したイベントパターン情報が表示されていることに注意してください。これを受け入れるか、更新することができます。

   ルールを作成する方法の詳細については、「Amazon のイベントに反応するルールの作成 EventBridge」を参照してください。