Amazon EventBridge のターゲットとしての API 送信先 - Amazon EventBridge
サービスリンクロールリクエストのヘッダーAPI 送信先のエラーコード呼び出しレートとイベント配信利用可能なリージョン

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

Amazon EventBridge のターゲットとしての API 送信先

EventBridge API の送信先は、 AWS サービスまたはリソースをターゲットとして呼び出す方法と同様に、イベントバスルールまたはパイプのターゲットとして呼び出すことができる HTTPS エンドポイントです。API 送信先を使用すると、API コールを使用して、 AWS サービス、統合 Software as a Service (SaaS) アプリケーション、パブリックまたはプライベートアプリケーション間でイベントをルーティングできます。

API 送信先をルールまたはパイプターゲットとして指定すると、EventBridge はルールまたはパイプで指定されたイベントパターンに一致するイベントの HTTPS エンドポイントを呼び出し、リクエストとともにイベント情報を配信します。EventBridge では、CONNECT および TRACE 以外の任意の HTTP メソッドをリクエストに使用できます。最もよく使用する HTTP メソッドは PUT と POST です。

また、入力トランスフォーマーを使用して、イベントを特定の HTTP エンドポイントのパラメータにカスタマイズすることもできます。詳細については、「Amazon EventBridge 入力変換」を参照してください。

API 送信先は、認証パラメータとの接続を使用して HTTP エンドポイントにイベントを送信します。

EventBridge API の送信先は、接続を使用して、EventBridge が特定の HTTPS エンドポイントに接続するときに使用する認可方法、認証情報、ネットワーク接続を定義します。接続は、パブリック API とプライベート APIsの両方をサポートします。詳細については、「Connections」を参照してください。

注記

EventBridge API の送信先は現在、プライベート APIs を使用する場合、HTTPS エンドポイントのパブリックに信頼された証明書を持つパブリックドメイン名のみをサポートしています。API 送信先は相互 TLS (mTLS) をサポートしていません。

重要

API 送信先エンドポイントへの EventBridge リクエストは、クライアント実行タイムアウト時間を最大 5 秒までにする必要があります。ターゲットエンドポイントが応答に 5 秒以上かかる場合、EventBridge はリクエストをタイムアウトします。EventBridge はタイムアウトしたリクエストを、再試行ポリシーで設定された最大値まで再試行します。

  • イベントバスの場合、デフォルトでは最大数は 24 時間 185 回です。

  • パイプの場合、再試行はパイプソースタイプとその設定によって決まります。EventBridge は、イベントがソースから期限切れになるか、設定された最大イベント経過時間または再試行回数に達するまで再試行します。

再試行の最大回数を超えると、デッドレターキューがあればイベントはそこに送られ、なければイベントはドロップされます。

次の動画は、API 送信先の使用を示しています。

API 送信先のサービスにリンクされたロール

API 送信先の接続を作成すると、サービスにリンクされたロールAmazonEventBridgeApiDestinationsServiceRolePolicyがアカウントに追加されます。EventBridge はこのサービスにリンクされたロールを使用してシークレットを作成し、Secrets Manager に保存します。サービスにリンクされたロールに必要なアクセス許可を付与するために、EventBridge は、AmazonEventBridgeApiDestinationsServiceRolePolicy ポリシーをロールにアタッチします。このポリシーは、付与されるアクセス許可を、ロールが接続用のシークレットと対話するために必要なものだけに制限します。他のアクセス許可は含まれず、ロールはシークレットを管理するためにアカウント内の接続のみと対話できます。

サービスリンクロールの詳細については、「IAM ユーザーガイド」の「サービスリンクロールの使用」を参照してください。

API 送信先へのリクエストのヘッダー

次のセクションでは、EventBridge が API 送信先へのリクエストの HTTP ヘッダーをどのように処理するかについて詳しく説明します。

API 送信先へのリクエストに含まれるヘッダー

API 送信先に使用される接続に定義された認可ヘッダーに加えて、EventBridge は各リクエストに次のヘッダーを含めます。

ヘッダーキー ヘッダー値

ユーザーエージェント

Amazon/EventBridge/ApiDestinations

Content-Type

カスタム Content-Type 値が指定されていない場合、EventBridge には Content-Type として次のデフォルト値が含まれます。

application/json; charset=utf-8

Range

bytes=0-1048575

Accept-Encoding

gzip、deflate

接続

CLOSE

Content-Length

受信者に送信されるエンティティボディのサイズをバイト単位で示すエンティティヘッダー。

ホスト

リクエストを送信するサーバーのホストおよびポート番号を指定するリクエストヘッダー。

API 送信先へのリクエストの上書きできないヘッダー

EventBridge は、以下のヘッダーの上書きを許可しません。

  • ユーザーエージェント

  • Range

EventBridge が API 送信先へのリクエストから削除するヘッダー

EventBridge は、API 送信先へのリクエストから以下のヘッダーを削除します。

  • A-IM

  • Accept-Charset

  • Accept-Datetime

  • Accept-Encoding

  • Cache-Control

  • 接続

  • Content-Encoding

  • Content-Length

  • Content−MD5

  • 日付

  • Expect

  • Forwarded

  • From

  • ホスト

  • HTTP2-Settings

  • If-Match

  • If-Modified-Since

  • If-None-Match

  • If-Range

  • If-Unmodified-Since

  • Max-Forwards

  • オリジン

  • Pragma

  • Proxy-Authorization

  • Range

  • リファラー

  • TE

  • Trailer

  • Transfer-Encoding

  • ユーザーエージェント

  • アップグレード

  • Via

  • 警告

API 送信先のエラーコード

EventBridge が API にイベントを配信しようとしてエラーが発生した場合、EventBridge は次のように動作します。

  • エラーコード 401、、407、409、429および に関連するイベントを再試行します5xx。

  • エラーコード 1xx、、2xx、3xxおよび 4xx (上記を除く) に関連するイベントを再試行しません。

EventBridge API の送信先は、標準的な HTTP レスポンスヘッダーの Retry-After を読み、フォローアップリクエストを行う前の待機時間を調べます。イベントバスの場合、EventBridge は定義された再試行ポリシーと Retry-Afterヘッダーの間のより控えめな値を選択します。Retry-After 値が負の場合、EventBridge はそのイベントの配信の再試行を停止します。

呼び出しレートがイベント配信に与える影響

1 秒あたりの呼び出しレートを、生成された呼び出しの数より大幅に低い値に設定した場合、イベントの 24 時間の再試行時間内にはイベントが配信されないことがあります。例えば、呼び出しレートを 1 秒あたり 10 回に設定しても、1 秒あたり数千のイベントが生成されると、24 時間を超えるイベントのバックログがすぐに作成されてしまいます。イベントが失われないようにするには、デッドレターキューを設定して、呼び出しが失敗したイベントを送信し、後で処理できるようにします。詳細については、「EventBridge で配信されていないイベントを処理するためのデッドレターキューの使用」を参照してください。

利用可能なリージョン

パブリック HTTPS エンドポイントへの API 送信先は、次の AWS リージョンでサポートされています。

  • 米国東部 (バージニア北部)

  • 米国東部 (オハイオ)

  • 米国西部 (北カリフォルニア)

  • 米国西部 (オレゴン)

  • アフリカ (ケープタウン)

  • アジアパシフィック (香港)

  • アジアパシフィック (東京)

  • アジアパシフィック (ソウル)

  • アジアパシフィック (大阪)

  • アジアパシフィック (ムンバイ)

  • アジアパシフィック (ハイデラバード)

  • アジアパシフィック (シンガポール)

  • アジアパシフィック (シドニー)

  • アジアパシフィック (ジャカルタ)

  • カナダ (中部)

  • 中国 (北京)

  • 中国 (寧夏)

  • 欧州 (フランクフルト)

  • 欧州 (チューリッヒ)

  • 欧州 (ストックホルム)

  • 欧州 (ミラノ)

  • 欧州 (スペイン)

  • 欧州 (アイルランド)

  • 欧州 (ロンドン)

  • 欧州 (パリ)

  • 中東 (アラブ首長国連邦)

  • 中東 (バーレーン)

  • 南米 (サンパウロ）