Amazon EventBridge Pipes イベントのエンリッチメント - Amazon EventBridge

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

Amazon EventBridge Pipes イベントのエンリッチメント

EventBridge Pipes のエンリッチメントステップでは、ソースからのデータをターゲットに送信する前に拡張できます。たとえば、チケットデータがすべて含まれていないチケット作成イベントを受け取る場合があります。エンリッチメントを使用すると、Lambda 関数で get-ticket API を呼び出して、チケットの詳細をすべて確認できます。その後、パイプはその情報をターゲットに送信できます。

EventBridge でパイプをセットアップする場合、以下のエンリッチメントを設定できます。

  • API 送信先

  • Amazon API Gateway

  • Lambda 関数

  • Step Functions ステートマシン

    注記

    EventBridge Pipes は、エクスプレスワークフローをエンリッチメントとしてのみサポートしています。

EventBridge は、エンリッチメントからのレスポンスを待ってからターゲットを呼び出す必要があるため、エンリッチメントを同期的に呼び出します。

エンリッチメントのレスポンスは、最大サイズが 6 MB に制限されます。

また、ソースから受け取ったデータを送信する前に変換して拡張することもできます。詳細については、「Amazon EventBridge Pipes の入力変換」を参照してください。

エンリッチメントによるイベントのフィルタリング

EventBridge Pipes は、エンリッチメントのレスポンスを設定されたターゲットに直接渡します。これには、バッチをサポートするターゲットの配列レスポンスが含まれます。バッチ動作の詳細については、「Amazon EventBridge Pipes のバッチ処理と同時実行」を参照してください。エンリッチメントをフィルターとして使用して、ソースから受信したイベントよりも少ないイベントを渡すこともできます。ターゲットを呼び出したくない場合は、""{}、または [] などの空のレスポンスを返します。

注記

空のペイロードでターゲットを呼び出す場合は、空の JSON [{}] を含む配列を返します。

エンリッチメントの呼び出し

EventBridge は、エンリッチメントからのレスポンスを待ってからターゲットを呼び出す必要があるため、エンリッチメントを同期的に (呼び出しタイプを REQUEST_RESPONSE に設定して) 呼び出します。

注記

Step Functions ステートマシンでは、EventBridge はエンリッチメントとして Express ワークフローのみサポートします。このワークフローは同期的に呼び出すことができるためです。