翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon EventBridge のルール
各イベントバスに配信されるイベント EventBridge の処理を指定します。これを行うには、*ルール*を作成します。ルールは、どのイベントがどの[ターゲット](eb-targets.md)に送信して処理を行うかを指定します。1 つのルールで複数のターゲットにイベントを送信し、並行して実行することができます。
イベントが配信されるときにイベントデータに一致するルールと、定義されたスケジュールで実行されるルールの 2 種類のルールを作成できます。さらに、特定の AWS サービスでは、アカウントでルールを作成および管理することもできます。
## イベントデータに一致するルール
イベントデータ条件 (*イベントパターン*と呼ばれる) に基づいて、受信イベントに一致するルールを作成できます。イベントパターンでは、ルールでマッチングするイベント構造とフィールドを定義します。イベントがイベントパターンで定義された条件と一致する場合、 EventBridge は指定したターゲット (複数可) に送信します。
詳細については、「[Amazon EventBridge でのルールの作成](eb-create-rule-visual.md)」を参照してください。
## スケジュールで実行されるルール
**注記**
スケジュールされたルールは EventBridge のレガシー機能です。
EventBridge は、スケジュールされたタスクを大規模に一元的に作成、実行、管理するための、より柔軟で強力な方法を提供します: EventBridge スケジューラ。EventBridge スケジューラでは、繰り返しのパターンに cron やレート式を使ってスケジュールを作成したり、1回限りの呼び出しを設定したりできます。配信時間枠の柔軟な設定、再試行制限の定義、失敗した API 呼び出しの最大保持時間の設定を行うことができます。
スケジューラは高度にカスタマイズ可能で、ターゲット API オペレーションと AWS サービスの幅広いセットにより、スケジュールされたルールよりもスケーラビリティが向上します。スケジュールに従ってターゲットを呼び出すには、Scheduler を使用することをお勧めします。
詳細については、[新しいスケジュールを作成する](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create)「」または*[EventBridge スケジューラユーザーガイド](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)*」を参照してください。
また、指定した間隔で指定したターゲットにイベントを送信するルールを作成することもできます。たとえば、 Lambda 関数を定期的に実行するには、スケジュールに従って実行するルールを作成できます。
詳細については、「[Amazon EventBridge でスケジュールされたルール (レガシー) を作成する](eb-create-rule-schedule.md)」を参照してください。
## AWS サービスによって管理されるルール
作成したルールに加えて、 AWS サービスは、それらのサービスの特定の関数に必要な EventBridge ルールを AWS アカウントに作成および管理できます。これらは、*マネージドルール*と呼ばれます。
サービスがマネージドルールを作成するとき、ルールを作成するアクセス許可をそのサービスに付与する [IAM ポリシー](eb-iam.md)も作成できます。この方法で作成された IAM ポリシーは、リソースレベルのアクセス許可で範囲を絞り込み、必要なルールの作成のみを許可します。
マネージドルールは、**強制削除**オプションを使って削除できますが、他のサービスでそのルールが不要になったことが確実な場合にのみ削除してください。それ以外の場合、マネージドルールを削除すると、このルールに依存する機能が動作しなくなります。
# Amazon EventBridge でのルールの作成
## 前提条件
開始する前に、以下を確認してください。
+ Amazon EventBridge コンソールへのアクセス
+ EventBridge ルールを作成するための適切な IAM アクセス許可
+ イベント駆動型アーキテクチャの基本的な理解
## 概要:
EventBridge が受信したイベントに対してアクションを実行するには、ルールを作成できます。イベントがルールで定義されたイベントパターンと一致すると、EventBridge は指定されたターゲットにイベントを送信します。
このトピックでは、指定したイベントバスに送信されるイベントを EventBridge が一致させるために使用するルールを作成する方法について説明します。
EventBridge ルールの作成には、主に 4 つのステップがあります。
1. 処理するイベントを選択する
1. イベントフィルタリングとテストを設定する
1. ターゲットの選択と設定
1. ルール設定を構成する
## イベントを選択する
まず、ターゲットに送信するイベントを選択します。
**イベントを選択するには**
1. Amazon EventBridge コンソール の[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) を開いてください。
1. ナビゲーションペインで、**ルール**を選択し、**ルールの作成**を選択します。
1. Events ****タブで、ターゲットに送信するイベントを見つけます。
1. **AWS サービスイベント**または**カスタムイベント**を選択します。
1. 検索ボックスを使用するか、イベントリストを参照して、ターゲットに送信するイベントを見つけます。
1. 1 つ以上のイベントを**ビルド**キャンバスにドラッグし、**トリガーイベントにドロップします**。
EventBridge は**トリガーイベント**セクションを表示します。このセクションには以下が含まれます。
+ 選択した**イベント**を一覧表示するイベント。
+ **スキーマ**。使用可能な場合は、選択したイベントのスキーマを表示します。
**スキーマ**には 3 つのタブがあります。
+ **ツリー**: イベントスキーマのツリービュー。
+ **コード**: Open API 仕様または JSON 形式のイベントスキーマ。
+ **情報**: スキーマの概要情報。
+ **サンプルイベント**。使用可能な場合は、選択したイベントのサンプルを表示します。
+ 選択したすべての**イベントを選択するイベントパターンを含むイベントパターン (フィルタ)**。
## 必要なもののみを送信するようにイベントをフィルタリングする
おそらく、特定のタイプの*すべての*イベントをターゲットに送信するわけではありません。イベントパターンをより具体的にすることで、関心のある属性と値を含むイベントのみを選択できます。
### イベントパターンを編集する (オプション)
**トリガーイベント**ペインでは、次の 2 つの方法でイベントパターンを構築できます。
+ **スキーマ**ツリービューを使用して視覚的に表示
+ **イベントパターン**ペインで JSON を直接編集する
**スキーマツリービューを使用してイベントパターンを編集するには**
1. **スキーマ**ペインの**ツリー**タブを選択します。
1. フィルターを追加および編集して、イベントパターンを構築します。
1. イベントパターンにフィルターとして追加する属性の横にあるフィルターアイコンを選択します。
1. ドロップダウンリストから比較演算子を選択します。
比較演算子の詳細については、[「イベントパターンの作成](eb-create-pattern-operators.md)」を参照してください。
1. 一致させる値を入力します。
1. 完了するには、チェックマークをクリックします。
EventBridge は、作成したフィルターを**イベントパターン**ペインの JSON に追加します。
1. 必要なすべてのイベント属性に一致するイベントパターンを構築するまで、フィルターを追加します。
### イベントパターンをテストする
必要なすべてのイベント属性に一致するイベントパターンを構築したら、イベントパターンが期待どおりに動作することをテストします。
#### イベントパターンをテストする (オプション)
1. テスト用のサンプルイベントを選択するか、独自のイベントを使用します。
+ **提供されたサンプルイベントを使用する**
1. **提供されたサンプルイベントを使用する** を選択します。
1. **サンプルトリガーイベント**で、ドロップダウンリストからテストに使用するイベントを選択します。
+ **独自のイベントを使用する**
1. **[独自のイベントを使用]** を選択します。
EventBridge は、空の `details` 要素を持つ汎用イベントを表示します。
1. イベント JSON を編集して、イベントパターンをテストするイベントを作成します。
**ヒント**
テストで使用する独自のカスタムイベントを作成するための開始点として、提供されているサンプルイベントを使用できます。
**[提供されたサンプルイベントを使用]** を選択し、**[サンプルトリガーイベント]** からイベントを選択して、**[コピー]** を選択します。
**[独自のイベントを使用]** を選択します。
ウィンドウでイベント全体を選択し、サンプルイベントを貼り付けます。
必要に応じてイベントを編集します。
1. **テストの実行** を選択します。
EventBridge は、テストイベントがイベントパターンと一致するかどうかを示すメッセージを表示します。
## ターゲットを選択する
1 つ (および最大 5 つ) のターゲットを**ビルド**キャンバスにドラッグし、**ターゲット**にドロップして、指定されたイベントパターンに一致するイベントを受信します。ターゲットには以下が含まれます。
+ 同じ または別の EventBridge イベントバス AWS アカウント
+ Salesforce などの SaaS パートナーを含む EventBridge API の送信先
+ Amazon SQS キューや Amazon SNS トピックなど、さまざまな AWS サービスリソース
**ターゲットを選択するには**
1. ターゲットペインから**ターゲット**タイプを選択し、ビルドキャンバスの**ターゲット**シェイプにドロップします。
EventBridge は、ビルドの**ターゲット**セクションに、選択したターゲットのタイプに基づいて該当する設定オプションを表示します。
**ヒント**
複数のターゲットを指定した場合、ターゲットシェイプを選択すると、そのターゲットの設定セクションが表示されます。
1. ターゲットタイプに基づいてターゲットを設定します。詳細な設定手順については、[EventBridge ターゲット](eb-targets.md)」を参照してください。
### ターゲットに送信されるイベントデータをカスタマイズする
EventBridge イベントバスまたは EventBridge API 送信先以外のターゲットを選択した場合は、ターゲットに実際に配信されるデータをカスタマイズできます。
#### 送信されたイベントデータを変換または置き換える (オプション)
1. ビルドデザインキャンバスで、**ターゲット**シェイプ**の入力変換**アイコンを選択します。
EventBridge は**入力変換**セクションを表示します。
1. **入力変換設定**で、**有効化** を選択します。
1. 変換方法を選択して、一致するイベントのためにターゲットに送信されるテキストをカスタマイズする方法を選択します。
+ **一致したイベントの一部** — EventBridge は、元のソースイベントの指定された部分のみをターゲットに送信します。
+ **定数 (JSON テキスト)** — EventBridge は指定された JSON テキストのみをターゲットに送信します。元のソースイベントは、いずれの部分も送信されません。
+ **入力トランスフォーマー** – EventBridge がターゲットに送信するテキストをカスタマイズするように入力トランスフォーマーを設定します。詳細については、[「ターゲット入力の変換](eb-transform-target-input.md)」を参照してください。
## ルールを設定する
最後に、ルールを設定して作成します。
**ルールを設定するには (コンソール)**
1. [**設定**] を選択します。
1. ルールの**名前**を入力し、オプションで**説明**を入力します。
ルールは、同じ AWS リージョン および同じイベントバスの別のルールと同じ名前にすることはできません。
1. **[Event bus]** (イベントバス) で、このルールに関連付けるイベントバスを選択します。
このルールをアカウントからのイベントと一致させるには、**AWS のデフォルトのイベントバス**を選択します。 AWS のサービス アカウントの がイベントを送信すると、常にアカウントのデフォルトのイベントバスに送信されます。
1. ルールが作成されるとすぐに有効にするには、**アクティベーション **で**アクティブ**を有効にします。
1. (オプション) ルールに 1 つ以上のタグを入力します。詳細については、「[Amazon EventBridge でのリソースのタグ付け](eb-tagging.md)」を参照してください。
1. **[作成]** を選択します。
## 次の手順
ルールを作成したら、次のことができます。
+ [メトリクスを使用してルールのパフォーマンスをモニタリングする](eb-monitoring.md)
+ [サンプルイベントでルールをテストする](eb-event-pattern-sandbox.md)
+ [必要に応じてイベントパターンを変更する](eb-event-patterns.md)
+ [既存のルールにターゲットを追加する](eb-targets.md)
## その他のリソース
EventBridge ルールの詳細については、以下を参照してください。
+ [EventBridge ルールの概要](eb-rules.md)
+ [イベントパターンの作成](eb-event-patterns.md)
+ [EventBridge ターゲット](eb-targets.md)
+ [EventBridge ルールのトラブルシューティング](eb-troubleshooting.md)
# Amazon EventBridge でイベントに応答するルールの作成
Amazon EventBridge が受信したイベントに対してアクションを実行するには、[ルール](eb-rules.md)を作成できます。イベントがルールで定義した[イベントパターン](eb-event-patterns.md)に一致すると、EventBridge は指定された[ターゲット](eb-targets.md)にイベントを送信し、ルールで定義されたアクションをトリガーします。
次の手順では、EventBridge で指定先のイベントバスに送信するイベントのマッチングに使用するルールの作成方法を示します。
**Topics**
+ [ルールを定義する](#eb-create-rule-define)
+ [イベントパターンを作成する](#eb-create-rule-event-pattern)
+ [ターゲットを選択する](#eb-create-rule-target)
+ [タグとレビュールールを設定する](#eb-create-rule-review)
## ルールを定義する
まず、ルールを識別するため、ルールの名前と説明を入力します。また、ルールがイベントパターンに一致するイベントを検索するイベントバスも定義する必要があります。
**ルールの詳細を定義するには**
1. Amazon EventBridge コンソール ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)) を開きます。
1. ナビゲーションペインで **[ルール]** を選択します。
1. **[ルールを作成]** を選択します。
1. ルールの**名前**を入力し、オプションで**説明**を入力します。
ルールは、同じ AWS リージョン および同じイベントバスの別のルールと同じ名前にすることはできません。
1. **[Event bus]** (イベントバス) で、このルールに関連付けるイベントバスを選択します。このルールをアカウントからのイベントと一致させるには、**AWS のデフォルトのイベントバス**を選択します。 AWS のサービス アカウントの がイベントを発行すると、常にアカウントのデフォルトのイベントバスに送られます。
1. **[ルールタイプ]** で、**[イベントパターンを持つルール]** を選択してください。
1. [**次へ**] を選択します。
## イベントパターンを作成する
次に、イベントパターンを作成します。そのためには、イベントソースを指定し、イベントパターンのベースを選択し、照合する属性と値を定義します。また、JSON でイベントパターンを生成し、サンプルイベントに対してテストすることもできます。
**イベントパターンを作成するには**
1. **[イベントソース]** で、**[AWS イベントまたは EventBridge パートナーイベント]** を選択してください。
1. (オプション) **[サンプルイベント]** セクションで、イベントパターンを照らし合わせてテストする **[サンプルイベントタイプ]** を選択します。
次のサンプルイベントタイプを使用できます｡
+ **AWS events **– サポートされている から出力されるイベントから選択します AWS のサービス。
+ **[EventBridge partner events]** (EventBridge パートナーイベント) — Salesforce など、EventBridge をサポートしているサードパーティのサービスから送信されるイベントから選択できます。
+ **[自分のイベントを入力]** — 自分のイベントを JSON テキストで入力します。
独自のカスタムイベントを作成するための開始点として、 AWS または パートナーイベントを使用することもできます。
1. **[AWS イベント]** または **[EventBridge パートナーイベント]** を選択します。
1. **[サンプルイベント]** ドロップダウンを使用して、カスタムイベントの開始点として使用するイベントを選択します。
EventBridge にサンプルイベントが表示されます。
1. **[コピー]** を選択します。
1. **[イベントタイプ]** で **[自分のイベントを入力]** を選択します。
1. JSON 編集ペインのサンプルイベント構造を削除し、代わりに AWS または パートナーイベントを貼り付けます。
1. イベント JSON を編集して独自のサンプルイベントを作成します。
1. **[Creation method]** (作成方法) を選択します。イベントパターンは、EventBridge のスキーマまたはテンプレートから定義するか、またはカスタムイベントパターンを作成できます。
------
#### [ Existing schema ]
既存の EventBridge スキーマを使用してイベントパターンを作成するには、以下を実行します。
1. **[Creation method]** (作成方法) セクションの **[Method]** (メソッド) で、**[Use schema]** (スキーマを使用) を選択します。
1. **[Event pattern]** (イベントパターン) セクションの **[Schema type]** (スキーマタイプ) で、**[Select schema from Schema registry]** (スキーマレジストリからスキーマを選択) を選択します。
1. **[Schema registry]** (スキーマレジストリ) では、ドロップダウンボックスを選択して、`aws.events` などのスキーマレジストリの名前を入力します。表示されるドロップダウンリストからオプションを選択することもできます。
1. **[Schema]** (スキーマ) では、ドロップダウンボックスを選択して、使用するスキーマの名前を入力します。例えば、`aws.s3@ObjectDeleted`。表示されるドロップダウンリストからオプションを選択することもできます。
1. **[Models]** (モデル) セクションでは、任意の属性の横にある **[Edit]** (編集) ボタンを選択してプロパティを開きます。必要に応じて **[Relationship]** (関係) フィールドと **[Value]** (値) フィールドを設定し、次に **[Set]** (設定) を選択して属性を保存します。
**注記**
属性の定義については、属性名の横にある**[Info]** (情報) アイコンを選択してください。イベントで属性のプロパティを設定する方法については、属性のプロパティダイアログボックスの **[Note]** (注意) セクションを開いてください。
属性のプロパティを削除するには、その属性の **[Edit]** (編集) ボタンを選択し、**[Clear]** (クリア) を選択します。
1. **[Generate event pattern in JSON]** (JSON でイベントパターンを生成) を選択し、イベントパターンを JSON テキストとして生成して検証します。
1. (オプション) サンプルイベントをテストパターンと照らし合わせてテストするには、**[テストパターン]** を選択します。
サンプルイベントがイベントパターンと一致するかどうかを示すメッセージボックスが表示されます。
次のオプションのいずれかを選択することもできます。
+ **[Copy]** (コピー) — イベントパターンをデバイスのクリップボードにコピーします。
+ **[Prettify]** (整文) — 改行、タブ、スペースを追加して JSON テキストを読みやすくします。
------
#### [ Custom schema ]
カスタムスキーマを記述し、それをイベントパターンに変換して、以下の操作を行います。
1. **[Creation method]** (作成方法) セクションの **[Method]** (メソッド) で、**[Use schema]** (スキーマを使用) を選択します。
1. **[Event pattern]** (イベントパターン) セクションで、**[Schema type]** (スキーマの種類) で、**[Enter schema]** (スキーマを入力) を選択します。
1. テキストボックスにスキーマを入力します。スキーマは有効な JSON テキストとしてフォーマットする必要があります。
1. **[Models]** (モデル) セクションで、任意の属性の横にある**[Edit]** (編集) ボタンを選択してプロパティを開きます。必要に応じて **[Relationship]** (関係) フィールドと **[Value]** (値) フィールドを設定し、次に **[Set]** (設定) を選択して属性を保存します。
**注記**
属性の定義については、属性名の横にある**[Info]** (情報) アイコンを選択してください。イベントで属性のプロパティを設定する方法については、属性のプロパティダイアログボックスの **[Note]** (注意) セクションを開いてください。
属性のプロパティを削除するには、その属性の **[Edit]** (編集) ボタンを選択し、**[Clear]** (クリア) を選択します。
1. **[Generate event pattern in JSON]** (JSON でイベントパターンを生成) を選択し、イベントパターンを JSON テキストとして生成して検証します。
1. (オプション) サンプルイベントをテストパターンと照らし合わせてテストするには、**[テストパターン]** を選択します。
サンプルイベントがイベントパターンと一致するかどうかを示すメッセージボックスが表示されます。
次のオプションのいずれかを選択することもできます。
+ **[Copy]** (コピー) — イベントパターンをデバイスのクリップボードにコピーします。
+ **[Prettify]** (整文) — 改行、タブ、スペースを追加して JSON テキストを読みやすくします。
------
#### [ Event pattern ]
カスタムイベントパターンを JSON 形式で記述するには、以下を実行します。
1. **[Creation method]** (作成方法) セクションの **[Method]** (メソッド) で、**[Custom pattern (JSON editor)]** (カスタムパターン (JSON エディタ)) を選択します。
1. **[Event pattern]** (イベントパターン) には、カスタムイベントパターンを JSON 形式のテキストで入力します。
1. (オプション) サンプルイベントをテストパターンと照らし合わせてテストするには、**[テストパターン]** を選択します。
サンプルイベントがイベントパターンと一致するかどうかを示すメッセージボックスが表示されます。
次のオプションのいずれかを選択することもできます。
+ **[Copy]** (コピー) — イベントパターンをデバイスのクリップボードにコピーします。
+ **[Prettify]** (整文) — 改行、タブ、スペースを追加して JSON テキストを読みやすくします。
+ **[Event pattern form]** (イベントパターンフォーム) — パターンビルダーでイベントパターンを開きます。パターンをそのままパターンビルダーでレンダリングできない場合、EventBridge はパターンビルダーを開く前に警告を表示します。
------
1. [**次へ**] を選択します。
## ターゲットを選択する
指定されたパターンに一致するイベントを受信するターゲットを 1 つまたは複数選択します。ターゲットには、EventBridge のイベントバス、Salesforce などの SaaS パートナーを含む EventBridge API 送信先、または別の AWS のサービスを含めることができます。
**ターゲットを選択するには**
1. **[ターゲットタイプ]** で、以下のいずれかのターゲットタイプを選択します。
------
#### [ Event bus ]
1. **[EventBridge イベントバス]** を選択します。
1. ターゲットとして使用するイベントバスを選択します。
+ このルール AWS リージョン と同じ でイベントバスを使用するには:
1. **[同じアカウントとリージョン内のイベントバス]** を選択します。
1. **[ターゲットのイベントバス]** でドロップダウンボックスを選択し、イベントバスの名前を入力します。ドロップダウンリストからイベントバスを選択することもできます。
詳細については、「[Amazon EventBridge で同じアカウントおよび同じリージョンのイベントバス間でのイベントの送信](eb-bus-to-bus.md)」を参照してください。
+ このルールとして別の AWS リージョン またはアカウントでイベントバスを使用するには:
1. **[別のアカウントまたはリージョン内のイベントバス]** を選択します。
1. **[ターゲットとしてのイベントバス]** に、使用するイベントバスの ARN を入力します。
詳細については、以下を参照してください。
+ [Amazon EventBridge の AWS アカウント間でイベントを送受信する](eb-cross-account.md)
+ [Amazon EventBridge の AWS リージョン間でイベントを送受信する](eb-cross-region.md)
1. 多くのターゲットタイプでは、EventBridge はターゲットにイベントを送信するためのアクセス許可が必要です。これらの場合、EventBridge は、イベントの実行に必要な IAM ロールを作成できます。
**[Execution role]** (実行ロール) では、次のいずれかを実行します。
+ このルールの新しい実行ロールを作成するには:
1. **[この特定のリソースについて新しいロールを作成]** を選択します。
1. この実行ロールの名前を入力するか、EventBridge によって生成された名前を使用します。
+ このルールに既存の実行ロールを使用するには:
1. **[既存のロールを使用]** を選択します。
1. 使用する実行ロールの名前を入力するか、ドロップダウンリストから選択します。
1. (オプション) **[追加設定]** には、ターゲットタイプで使用できるオプション設定のいずれかを指定します。
(オプション) **[デッドレターキュー]** で、標準 Amazon SQS キューをデッドレターキューとして使用するかどうかを選択します。EventBridge は、このルールに一致するイベントがターゲットに正常に配信されなかった場合に、そのイベントをデッドレターキューに送信します。次のいずれかを行います。
+ デッドレターキューを使用しない場合は、**[None]** (なし) を選択します。
+ **Select an Amazon SQS queue in the current AWS account to use as the dead-letter queue**(デッドレターキューとして使用する現在の アカウントの Amazon SQS キューを選択) を選択し、ドロップダウンリストから使用するキューを選択します。
+ **Select an Amazon SQS queue in an other AWS account as a dead-letter queue**(他の アカウントの Amazon SQS キューをデッドレターキューとして選択) を選択し、使用するキューの ARN を入力します。キューにメッセージを送信するための EventBridge 許可を付与するリソースベースのポリシーをそのキューにアタッチする必要があります。
詳細については、「[デッドレターキューへのアクセス許可の付与](eb-rule-dlq.md#eb-dlq-perms)」を参照してください。
------
#### [ API destination ]
1. **[EventBridge API の宛先]** を選択します。
1. 新規または既存の API 送信先を選択します。
+ 既存の API 送信先を使用するには、**[Use an existing API destination]** (既存の API 送信先を使用する) を選択します。次に、ドロップダウンリストから API 送信先を選択します。
+ 新しい API 送信先を作成するには、**[Create a new API destination]** (新しい API 送信先を作成する) を選択します。次に、送信先について次の詳細を指定します。
+ **[Name]** (名前) に、イベント送信先の名前を入力します。
ロール名は AWS アカウント内で一意である必要があります。文字列は 64 文字まで設定できます。有効な文字は、**A-Z**、**a-z**、**0-9**、および **.**、**\$1**、**-** (ハイフン) です。
+ (オプション) **[Description** (説明) に、アクションの簡潔な説明を入力します。
説明の長さは、最大 512 文字です。
+ **[API destination endpoint]** (API 送信先エンドポイント) — ターゲットの URL エンドポイント。
エンドポイント URL は **https** で始まる必要があります。**\$1** をパスパラメータワイルドカードとして含めることができます。ターゲットの `HttpParameters` 属性からパスパラメータを設定できます。
+ **[HTTP method]** (HTTP メソッド) — エンドポイントを呼び出すときに使用する HTTP メソッドを選択します。
+ (オプション) **[Invocation rate limit per second]** (1 秒あたりの呼び出しレート制限) — この送信先で 1 秒あたりに受け入れられる呼び出しの最大数を入力します。
この値はゼロより大きくなければなりません。デフォルトでは、この値は 300 に設定されます。
+ **[接続]** — 新しい接続を使用するか既存の接続を使用するかを選択します。
+ 既存の接続を使用するには、**[既存の接続を使用]** を選択し、ドロップダウンリストから接続を選択します。
+ この送信先に新しい接続を作成するには、**[新しい接続を作成]** を選択し、その接続の **[名前]**、**[送信先タイプ]**、および **[認証タイプ]** を定義します。この接続にオプションの **[Description]** (説明) を追加することもできます。
1. 多くのターゲットタイプでは、EventBridge はターゲットにイベントを送信するためのアクセス許可が必要です。これらの場合、EventBridge は、イベントの実行に必要な IAM ロールを作成できます。
**[Execution role]** (実行ロール) では、次のいずれかを実行します。
+ このルールの新しい実行ロールを作成するには:
1. **[この特定のリソースについて新しいロールを作成]** を選択します。
1. この実行ロールの名前を入力するか、EventBridge によって生成された名前を使用します。
+ このルールに既存の実行ロールを使用するには:
1. **[既存のロールを使用]** を選択します。
1. 使用する実行ロールの名前を入力するか、ドロップダウンリストから選択します。
1. (オプション) **[追加設定]** には、ターゲットタイプで使用できるオプション設定のいずれかを指定します。
EventBridge では、特定の AWS サービスについて以下のフィールドがすべて表示されない場合があります。
1. (オプション) [ターゲット入力を設定] で、一致するイベントに対してターゲットに送信されるテキストをカスタマイズする方法を選択します。次のいずれかを選択します。
+ **一致したイベント** — EventBridge は元のソースイベント全体をターゲットに送信します。これがデフォルトです。
+ **一致したイベントの一部** — EventBridge は、元のソースイベントの指定された部分のみをターゲットに送信します。
**[一致したイベントの一部を指定]** で、EventBridge からターゲットに送信するイベント部分を定義する JSON パスを指定します。
+ **定数 (JSON テキスト)** — EventBridge は指定された JSON テキストのみをターゲットに送信します。元のソースイベントは、いずれの部分も送信されません。
**[JSON で定数を指定]** で、EventBridge がイベントの代わりにターゲットに送信する JSON テキストを指定します。
+ **入力トランスフォーマー** — EventBridge からターゲットに送信するテキストをカスタマイズするように入力トランスフォーマーを設定します。詳細については、「[Amazon EventBridge 入力変換](eb-transform-target-input.md)」を参照してください。
1. **[入力トランスフォーマーを設定]** を選択します。
1. 「[EventBridge でルールを作成するときに入力トランスフォーマーを設定する](eb-transform-input-rule.md)」の手順に従って入力トランスフォーマーを設定します。
1. (オプション) **[再試行ポリシー]** で、エラーが発生した後に EventBridge がターゲットへのイベント送信を再試行する方法を指定します。
+ **イベントの最大経過時間** — EventBridge が未処理のイベントを保持する最大時間 (時間、分、秒単位) を入力します。デフォルトは 24 時間です。
+ **再試行回数** — エラーが発生した後、EventBridge がターゲットへのイベント送信を再試行する最大回数を入力します。デフォルトは 185 回です。
1. (オプション) **[デッドレターキュー]** で、標準 Amazon SQS キューをデッドレターキューとして使用するかどうかを選択します。EventBridge は、このルールに一致するイベントがターゲットに正常に配信されなかった場合に、そのイベントをデッドレターキューに送信します。次のいずれかを行います。
+ デッドレターキューを使用しない場合は、**[なし]** を選択します。
+ **現在の AWS アカウントの Amazon SQS キューを選択してデッドレターキューとして使用し**、ドロップダウンリストから使用するキューを選択します。
+ **他の AWS アカウントの Amazon SQS キューをデッドレターキューとして選択** を選択し、使用するキューの ARN を入力します。キューにメッセージを送信するための EventBridge 許可を付与するリソースベースのポリシーをそのキューにアタッチする必要があります。
詳細については、「[デッドレターキューへのアクセス許可の付与](eb-rule-dlq.md#eb-dlq-perms)」を参照してください。
詳細については、「[Amazon EventBridge のターゲットとしての API 送信先](eb-api-destinations.md)」を参照してください。
------
#### [ AWS のサービス ]
1. **AWS のサービス** を選択します。
1. **[Select a target]** (ターゲットの選択) で、ターゲットとして使用する AWS のサービス を選択します。
1. クロスアカウントターゲットをサポートする AWS サービスを選択した場合は、イベントバスと同じアカウントのターゲットを選択するか、別のアカウントを選択できます。
+ 同じアカウントのターゲットの場合、**[ターゲットタイプ]** で **[このアカウントのターゲット]**を選択します。
1. 選択したサービスにリクエストされた情報を入力します。
**注記**
表示されるフィールドは、選択したサービスによって異なります。利用できるターゲットの詳細については、「[EventBridge コンソールで利用可能なイベントバスターゲット](eb-targets.md#eb-console-targets)」を参照してください。
1. 多くのターゲットタイプでは、EventBridge はターゲットにイベントを送信するためのアクセス許可が必要です。これらの場合、EventBridge は、イベントの実行に必要な IAM ロールを作成できます。
**[Execution role]** (実行ロール) では、次のいずれかを実行します。
+ このルールの新しい実行ロールを作成するには:
1. **[この特定のリソースについて新しいロールを作成]** を選択します。
1. この実行ロールの名前を入力するか、EventBridge によって生成された名前を使用します。
+ このルールに既存の実行ロールを使用するには:
1. **[既存のロールを使用]** を選択します。
1. 使用する実行ロールの名前を入力するか、ドロップダウンリストから選択します。
+ 別のアカウントのターゲットの場合、**ターゲットタイプ**で**別の AWS アカウントのターゲット**を選択します。
1. イベントを送信するターゲットリソースの ARN を入力します。
1. 選択したサービスにリクエストされた追加の情報を入力します。
1. 使用する実行ロールの名前をドロップダウンリストから選択します。
1. (オプション) **[追加設定]** には、ターゲットタイプで使用できるオプション設定のいずれかを指定します。
1. (オプション) [ターゲット入力を設定] で、一致するイベントに対してターゲットに送信されるテキストをカスタマイズする方法を選択します。次のいずれかを選択します。
+ **一致したイベント** — EventBridge は元のソースイベント全体をターゲットに送信します。これがデフォルトです。
+ **一致したイベントの一部** — EventBridge は、元のソースイベントの指定された部分のみをターゲットに送信します。
**[一致したイベントの一部を指定]** で、EventBridge からターゲットに送信するイベント部分を定義する JSON パスを指定します。
+ **定数 (JSON テキスト)** — EventBridge は指定された JSON テキストのみをターゲットに送信します。元のソースイベントは、いずれの部分も送信されません。
**[JSON で定数を指定]** で、EventBridge がイベントの代わりにターゲットに送信する JSON テキストを指定します。
+ **入力トランスフォーマー** — EventBridge からターゲットに送信するテキストをカスタマイズするように入力トランスフォーマーを設定します。詳細については、「[Amazon EventBridge 入力変換](eb-transform-target-input.md)」を参照してください。
1. **[入力トランスフォーマーを設定]** を選択します。
1. 「[EventBridge でルールを作成するときに入力トランスフォーマーを設定する](eb-transform-input-rule.md)」の手順に従って入力トランスフォーマーを設定します。
1. (オプション) **[再試行ポリシー]** で、エラーが発生した後に EventBridge がターゲットへのイベント送信を再試行する方法を指定します。
+ **イベントの最大経過時間** — EventBridge が未処理のイベントを保持する最大時間 (時間、分、秒単位) を入力します。デフォルトは 24 時間です。
+ **再試行回数** — エラーが発生した後、EventBridge がターゲットへのイベント送信を再試行する最大回数を入力します。デフォルトは 185 回です。
1. (オプション) **[デッドレターキュー]** で、標準 Amazon SQS キューをデッドレターキューとして使用するかどうかを選択します。EventBridge は、このルールに一致するイベントがターゲットに正常に配信されなかった場合に、そのイベントをデッドレターキューに送信します。次のいずれかを行います。
+ デッドレターキューを使用しない場合は、**[なし]** を選択します。
+ **現在の AWS アカウントの Amazon SQS キューを選択してデッドレターキューとして使用し**、ドロップダウンリストから使用するキューを選択します。
+ **他の AWS アカウントの Amazon SQS キューをデッドレターキューとして選択** を選択し、使用するキューの ARN を入力します。キューにメッセージを送信するための EventBridge 許可を付与するリソースベースのポリシーをそのキューにアタッチする必要があります。
詳細については、「[デッドレターキューへのアクセス許可の付与](eb-rule-dlq.md#eb-dlq-perms)」を参照してください。
------
1. (オプション) **[Add another target]** (別のターゲットを追加) を選択して、このルールに別のターゲットを追加します。
1. [**次へ**] を選択します。
## タグとレビュールールを設定する
最後に、ルールに一致する任意のタグを入力し、ルールを確認して作成します。
**タグを設定し、ルールを確認して作成するには**
1. (オプション) ルールに 1 つ以上のタグを入力します。詳細については、「[Amazon EventBridge でのリソースのタグ付け](eb-tagging.md)」を参照してください。
1. **[Next]** (次へ) を選択します。
1. 新しいルールの詳細を確認します。セクションを変更するには、そのセクションの横にある **[Edit]** (編集) ボタンを選択します。
ルールの詳細を確認したら、**[Create rule]** (ルールを作成) を選択します。
# Amazon EventBridge のルールの無効化または削除
[ルール](eb-rules.md)によって[イベント](eb-events.md)が処理されたり、スケジュールに従って実行されたりしないようにするには、ルールを削除または無効化します。次の手順では、EventBridge ルールを削除または無効化する方法について説明します。
**ルールを削除または無効化するには**
1. Amazon EventBridge コンソール ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)) を開きます。
1. ナビゲーションペインで **[ルール]** を選択します。
**Event bus (イベントバス)**] で、ルールに関連付けられているイベントバスを選択します。
1. 次のいずれかを行います。
1. ルールを削除するには、ルールの横にあるボタンを選択し、[**アクション**]、[**削除**]、[**削除**] の順に選択します。
ルールがマネージドルールである場合は、ルールの名前を入力してそれがマネージドルールであること、およびルールを削除するとルールの作成元のサービスが機能しなくなる場合があることを了承します。続行するには、ルール名を入力し、[**Force 削除 (強制削除)**] を選択します。
1. ルールを一時的に無効化するには、ルールの横にあるボタンを選択し、[**Disable (無効化)**]、[**Disable (無効化)**] の順に選択します。
マネージドルールを無効化することはできません。
# Amazon EventBridge のルールを定義する際のベストプラクティス
イベントバスのルールを作成する際に考慮すべきいくつかのベストプラクティスを以下に示します。
## ルールごとに 1 つのターゲットを設定する
1 つのルールに最大 5 つのターゲットを指定できますが、ルールごとに 1 つのターゲットを指定する方がルールの管理が容易になります。複数のターゲットが同じイベントセットを受信する必要がある場合は、ルールを複製して同じイベントを異なるターゲットに配信することをお勧めします。このカプセル化により、ルールの管理が簡単になります。イベントターゲットのニーズが時間の経過とともにそれていく場合は、各ルールとそのイベントパターンを他のルールとは独立して更新できます。
## ルールのアクセス許可を設定する
イベントを消費するアプリケーションコンポーネントまたはサービスが、独自のルールを管理できるようにすることができます。お客様が採用する一般的なアーキテクチャアプローチは、個別の AWS アカウントを使用してこれらのアプリケーションコンポーネントまたはサービスを分離することです。あるアカウントから別のアカウントへのイベントのフローを有効にするには、別のアカウントのイベントバスにイベントをルーティングするルールを 1 つのイベントバスに作成する必要があります。イベントを消費するチームまたはサービスが、独自のルールを管理できるようにすることができます。そのためには、リソースポリシーを通じてアカウントへの適切なアクセス許可を指定します。これはアカウントとリージョン間で機能します。
詳細については、「[Amazon EventBridge イベントバスのアクセス許可](eb-event-bus-perms.md)」を参照してください。
リソースポリシーの例については、GitHub の「[Multi-account design patterns with Amazon EventBridge](https://github.com/aws-samples/amazon-eventbridge-resource-policy-samples/tree/main/patterns)」(Amazon EventBridge によるマルチアカウントデザインパターン) を参照してください。
## ルールのパフォーマンスを監視する
ルールを監視して、想定どおりに動作していることを確認します。
+ データポイントの欠落や異常がないか、`TriggeredRules` メトリクスを監視すると、重大な変更を加えたパブリッシャーの差異を検出しやすくなります。詳細については、「[Amazon EventBridge のモニタリング](eb-monitoring.md)」を参照してください。
+ 異常発生時のアラームや最大想定回数の設定も、ルールが新しいイベントと合致しているかどうかを検出するのに役立ちます。これは、 AWS サービスや SaaS パートナーを含むイベントパブリッシャーが、新しいユースケースや機能を導入する際に新しいイベントを導入した場合に発生する可能性があります。これらの新しいイベントが予期せぬものであり、ダウンストリームターゲットの処理速度よりも処理量が多くなる場合、イベントバックログにつながる可能性があります。
このような予期しないイベントの処理は、不要な料金につながる可能性もあります。
また、アカウントが 1 秒あたりのサービスクォータの総ターゲット呼び出し数の上限を超えると、ルールのスロットリングをトリガーする可能性もあります。EventBridge は引き続き、スロットリングされたルールに一致するイベントの配信を試み、最大 24 時間まで、またはターゲットのカスタム再試行ポリシーに記載されているとおりに再試行します。`ThrottledRules` メトリクスを使用してスロットリングされたルールを検出し、警告することができます。
+ 低レイテンシーのユースケースでは、`IngestionToInvocationStartLatency` を使用してレイテンシーを監視することもでき、これにより、イベントバスの状態を確認できます。30 秒を超える長時間のレイテンシーは、サービスの中断またはルールのスロットリングを示している可能性があります。
# AWS Serverless Application Model テンプレートを使用した Amazon EventBridge リソースのデプロイ
EventBridge コンソールで[ルール](eb-rules.md)の構築とテストを手動で行うことができ、[イベントパターン](eb-event-patterns.md)を改良する時の開発プロセスに役立ちます。ただし、アプリケーションをデプロイする準備ができたら、すべてのサーバーレスリソースを一貫して起動できる [AWS SAM](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html) のようなフレームワークを使用する方が簡単です。
この[サンプルアプリケーション](https://github.com/aws-samples/amazon-eventbridge-producer-consumer-example)を使用して、 AWS SAM テンプレートを使用して EventBridge リソースを構築する方法を確認します。この例の template.yaml ファイルは、4 つの[AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)関数を定義する AWS SAM テンプレートであり、Lambda 関数を EventBridge と統合する 2 つの異なる方法を示しています。
このサンプルアプリケーションのチュートリアルについては、[チュートリアル: Amazon EventBridge サンプルアプリケーションを作成する](eb-tutorial-get-started.md) を参照してください。
EventBridge と AWS SAM テンプレートを使用する方法は 2 つあります。1 つのルールによって 1 つの Lambda 関数が呼び出される単純な統合では、**[Combined template] (組み合わせテンプレート)** アプローチをお勧めします。複雑なルーティングロジックがある場合、または AWS SAM テンプレート外のリソースに接続する場合は、**分離されたテンプレート**アプローチの方が適しています。
**Topics**
+ [組み合わせテンプレート](#eb-combined-template)
+ [分離テンプレート](#eb-separated-template)
## 組み合わせテンプレート
最初のアプローチでは、`Events` プロパティを使用して、EventBridge ルールを設定します。次のサンプルコードでは、Lambda 関数を呼び出す[イベント](eb-events.md)を定義します。
**注記**
この例では、すべての AWS アカウントに存在するデフォルトの[イベントバス](eb-event-bus.md)にルールを自動的に作成します。ルールをカスタムイベントバスに関連付けるには、`EventBusName` をテンプレートに追加します。
```
atmConsumerCase3Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case3Handler
Runtime: nodejs12.x
Events:
Trigger:
Type: CloudWatchEvent
Properties:
Pattern:
source:
- custom.myATMapp
detail-type:
- transaction
detail:
result:
- "anything-but": "approved"
```
この YAML コードは、EventBridge コンソールのイベントパターンと同等です。YAML では、イベントパターンを定義するだけで、必要なアクセス許可を持つ IAM ロール AWS SAM が自動的に作成されます。
## 分離テンプレート
で EventBridge 設定を定義する 2 番目のアプローチでは AWS SAM、リソースはテンプレート内でより明確に分離されます。
1. まず、Lambda 関数を定義します。
```
atmConsumerCase1Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case1Handler
Runtime: nodejs12.x
```
1. 次に、`AWS::Events::Rule` リソースを使用してルールを定義します。プロパティはイベントパターンを定義し、[ターゲット](eb-targets.md)を指定することもできます。複数のターゲットを明示的に定義できます。
```
EventRuleCase1:
Type: AWS::Events::Rule
Properties:
Description: "Approved transactions"
EventPattern:
source:
- "custom.myATMapp"
detail-type:
- transaction
detail:
result:
- "approved"
State: "ENABLED"
Targets:
-
Arn:
Fn::GetAtt:
- "atmConsumerCase1Fn"
- "Arn"
Id: "atmConsumerTarget1"
```
1. 最後に、EventBridge にターゲットを呼び出すアクセス許可を付与する `AWS::Lambda::Permission` リソースを定義します。
```
PermissionForEventsToInvokeLambda:
Type: AWS::Lambda::Permission
Properties:
FunctionName:
Ref: "atmConsumerCase1Fn"
Action: "lambda:InvokeFunction"
Principal: "events.amazonaws.com"
SourceArn:
Fn::GetAtt:
- "EventRuleCase1"
- "Arn"
```
# 既存の EventBridge ルールから AWS CloudFormation テンプレートを生成する
AWS CloudFormation では、インフラストラクチャをコードとして扱うことで、アカウントとリージョン間で AWS リソースを一元的かつ反復可能な方法で設定および管理できます。CloudFormation では、これを実現するために、プロビジョニングおよび管理するリソースを定義するテンプレートを作成できます。**
EventBridge では、CloudFormation テンプレートの開発をすぐに開始するための補助として、アカウント内の既存のイベントバスからテンプレートを生成できます。テンプレートに含めるルールは 1 つ、または複数選択することができます。次に、これらのテンプレートに基づいて CloudFormation で管理するリソースの[スタックを作成](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)できます。
CloudFormation の詳細については、[*「 CloudFormation ユーザーガイド*」を参照してください。](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
**注記**
EventBridge は、生成されたテンプレートに[マネージドルール](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)を含みません。
イベントバスに含まれるルールを含め、[既存のイベントバスからテンプレートを生成する](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-generate-event-bus-template.html)こともできます。
**1 つ以上のルールから CloudFormation テンプレートを生成するには**
1. Amazon EventBridge コンソール ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)) を開きます。
1. ナビゲーションペインで **[ルール]** を選択します。
1. **[Select event bus]** (イベントバスの選択) で、テンプレートに含めるルールを含むイベントバスを選択します。
1. **ルール** で、生成された CloudFormation テンプレートに含めるルールを選択します。
ルールが 1 つの場合は、ルールの詳細ページを表示するためのルール名を選択することもできます。
1. **[CloudFormation Template]** (CloudFormation テンプレート) を選択し、EventBridge でテンプレートを生成したいフォーマット (**JSON** または **YAML**) を選択します。
EventBridge には、選択した形式で生成されたテンプレートが表示されます。
1. EventBridge では、テンプレートファイルをダウンロードするか、テンプレートをクリップボードにコピーするかを選択できます。
+ テンプレートファイルをダウンロードするには、**[Download]** (ダウンロード) を選択します。
+ テンプレートをクリップボードにコピーするには、**[Copy]** (コピー) を選択します。
1. テンプレートを終了するには、**[Cancel]** (キャンセル) を選択します。
ユースケースに応じて CloudFormation テンプレートをカスタマイズしたら、それを使用して で[スタックを作成できます](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) CloudFormation。
## Amazon EventBridge から生成した CloudFormation テンプレートを使用する際の考慮事項
EventBridge から生成した CloudFormation テンプレートを使用するときは、次の点を考慮してください。
+ EventBridge は、生成テンプレートにパスワードを含みません。
テンプレートを編集して[テンプレートパラメータ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html)を含めると、ユーザーがテンプレートを使用して CloudFormation スタックを作成または更新するときに、パスワードやその他の機密情報を指定できるようになります。
さらに、ユーザーは Secrets Manager を使用して目的のリージョンにシークレットを作成し、生成されたテンプレートを編集して[動的パラメーター](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager)を使用できます。
+ 生成されたテンプレートのターゲットは、元のイベントバスで指定されていたものとまったく同じままです。テンプレートを使用して他のリージョンにスタックを作成する前に、テンプレートを適切に編集しないと、リージョン間の問題が発生する可能性があります。
また、生成したテンプレートでは、下流のターゲットが自動的には作成されません。