イベントルールを使用してイベントをフィルタリングし、API デスティネーションにルーティングできます。このトピックでは、カスタムイベントを API デスティネーションにルーティングするための前提条件と手順について説明します。また、結果を確認する方法についても説明します。
始める前に
ステップ 1：カスタムイベントソースを作成する
EventBridge コンソール にログインします。左側のナビゲーションペインで、[イベントバス] をクリックします。
上部のナビゲーションバーで、リージョンを選択します。[イベントバス] ページで、管理するカスタムイベントバスの名前をクリックします。
左側のナビゲーションペインで、[イベントソース] をクリックし、次に [イベントソースの追加] をクリックします。
[カスタムイベントソースの追加] パネルで、[名前] パラメーターと [説明] パラメーターを設定し、[イベントプロバイダー] ドロップダウンリストから [カスタムアプリケーション] を選択し、[OK] をクリックします。
ステップ 2：イベントルールを作成する
イベントルールに設定するイベントターゲットは、イベントルールと同じリージョンに存在する必要があります。
EventBridge コンソール にログインします。左側のナビゲーションペインで、[イベントバス] をクリックします。
上部のナビゲーションバーで、リージョンを選択します。[イベントバス] ページで、管理するイベントバスの名前をクリックします。
左側のナビゲーションペインで、[イベントルール] をクリックします。表示されるページで、[ルールの作成] をクリックします。
ルールの作成 ウィザードで、次の手順を実行し、作成 をクリックします。
[基本情報の構成] ステップで、[名前] パラメーターと [説明] パラメーターを設定し、[次のステップ] をクリックします。
[イベントパターンの構成] ステップで、[イベントソースタイプ] パラメーターを [カスタムイベントソース] に設定し、[イベントソース] ドロップダウンリストから作成したイベントソースを選択し、[次のステップ] をクリックします。
[ターゲットの構成] ステップで、パラメーターを設定し、[作成] をクリックします。
[サービスタイプ] パラメーターを [API デスティネーションによってトリガーされる] に設定します。
[基本情報] セクションで、パラメーターを設定します。次の表にパラメーターを示します。
パラメーター
例
説明
メソッド
カスタム
API デスティネーションを作成するために使用するメソッド。有効な値：
カスタム API デスティネーションの作成：このメソッドを選択した場合、現在のパネルで API デスティネーションを作成する必要があります。
既存の API デスティネーションの使用：このメソッドを選択した場合、事前に API デスティネーションを作成しておく必要があります。詳細については、「API デスティネーションを作成する」をご参照ください。
API デスティネーション名
testAPI
カスタム API デスティネーションの名前。
説明
なし
API デスティネーションの説明。このパラメーターはオプションです。
HTTP パラメーター
パラメーター：ヘッダー
キー：
Content-Type値：
multipart/form-data
HTTP パラメーター。[パラメーター] パラメーターの有効な値：
ヘッダー：メタデータはヘッダーを使用して送信されます。ヘッダーはキーと値のペアである必要があります。
本文：データはリクエスト本文を使用して送信されます。リクエスト本文は、キーと値のペア、または生のデータです。
クエリ：パラメーターは URL のクエリ文字列によって渡されます。文字列はキーと値のペアである必要があります。
[パラメーター] パラメーターの詳細な設定方法については、以下をご確認ください。
フォームデータ を選択した場合、[キー] パラメーターと [値] パラメーターには、[部分イベント]、[固定値]、[完全イベント] の値を使用できます。
Raw Data を選択した場合は、[変数] と [テンプレート] コードエディターで変数とテンプレートを設定する必要があります。詳細については、「テンプレート」をご参照ください。
[API 構成] セクションで、パラメーターを設定します。次の表にパラメーターを示します。
パラメーター
例
説明
URL
https://******アクセスするサーバーリソースの API URL。
HTTP メソッド
GET
サーバーリソースを取得するには、次のいずれかのメソッドを使用できます。
GET：指定されたリソースをリクエストし、エンティティ本文を返します。
POST：リクエスト本文に含まれるデータを指定されたリソースに送信し、サーバーにデータの処理をリクエストします。
PUT：指定されたリソースの最新コンテンツを特定の場所にアップロードします。
PATCH：指定されたリソースのコンテンツの一部を変更します。
DELETE：サーバーに指定されたリソースの削除をリクエストします。
HEAD：GET メソッドに類似したメソッド。このメソッドを使用すると、ステータス行とヘッダー情報のみがサーバーから返されます。
[接続構成] セクションで、パラメーターを設定します。次の表にパラメーターを示します。
パラメーター
例
説明
メソッド
接続の作成
接続を作成するために使用するメソッド。有効な値：
接続の作成：このメソッドを選択した場合、現在のパネルで接続を作成する必要があります。
既存の接続を選択：このメソッドを選択した場合、事前に接続を作成しておく必要があります。詳細については、「接続を作成する」をご参照ください。
名前
Connection-test
作成する接続の名前。
説明
なし
接続の説明。このパラメーターはオプションです。
認証
なし
認証方法。有効な値：
なし：認証なし。このメソッドを選択した場合、API デスティネーションはすべてのアクセスリクエストに応答します。
ベーシック：基本認証方法。このメソッドを選択した場合、認証に使用するユーザー名とパスワードを指定する必要があります。
OAuth クライアントクレデンシャル：OAuth 認証方法。このメソッドは、他のメソッドよりも安全で信頼性があります。
API キー：簡単な認証方法。このメソッドを選択した場合、API キーの名前と値を指定する必要があります。
ネットワーク
インターネット
ネットワークタイプ。有効な値：
インターネット
VPC：この値を選択した場合、事前に仮想プライベートクラウド (VPC)、vSwitch、およびセキュリティグループを作成しておく必要があります。詳細については、「VPC と vSwitch を作成する」、「vSwitch を作成する」、および「セキュリティグループを作成する」をご参照ください。
（オプション）。[再試行ポリシーとデッドレターキュー] セクションで、再試行ポリシー、フォールトトレランスポリシー、およびデッドレターキューを設定します。詳細については、「再試行ポリシーとデッドレターキュー」をご参照ください。
ステップ 3：イベントを公開する
EventBridge コンソール にログインします。左側のナビゲーションペインで、[イベントバス] をクリックします。
- 上部のナビゲーションバーで、リージョンを選択します。
[イベント バス] ページで、管理するカスタム イベント バスを見つけ、イベントのパブリッシュ を 操作 列でクリックします。
説明EventBridge コンソールでは、カスタムイベントバスにのみイベントを公開できます。
[カスタムイベントバスへのイベントの公開] パネルで、カスタムイベントソース ドロップダウンリストからカスタムイベントソースを選択し、イベント本体 コードエディターにイベントコンテンツを入力し、[OK] をクリックします。
説明イベントパラメーターの詳細については、「概要」をご参照ください。
[OK] をクリックすると、イベント ID が自動的にコピーされます。
結果の確認
管理するイベントバスの [概要] ページに移動します。
左側のナビゲーションペインで、[イベント追跡] をクリックします。次に、[イベント ID でクエリ] タブをクリックします。
[イベント ID] フィールドに、コピーしたイベント ID を貼り付けて、[クエリ] をクリックします。
クエリされたイベントの [操作] 列で、[イベントトレース] をクリックして、イベントが配信されているかどうかを確認します。
