Amazon EventBridge Pipes - Amazon EventBridge
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon EventBridge Pipes

Amazon EventBridge Pipes connects sources to targets. Pipes are intended for point-to-point integrations between supported sources and targets, with support for advanced transformations and enrichment. It reduces the need for specialized knowledge and integration code when developing event-driven architectures, fostering consistency across your company’s applications. To set up a pipe, you choose the source, add optional filtering, define optional enrichment, and choose the target for the event data.

Note

You can also route events using event buses. Event buses are well-suited for many-to-many routing of events between event-driven services. For more information, see Event buses in Amazon EventBridge.

How EventBridge Pipes work

At a high level, here's how EventBridge Pipes works:

  1. You create a pipe in your account. This includes:

    • Specifying one of the supported event sources from which you want your pipe to receive events.

    • Optionally, configuring a filter so that the pipe only processes a subset of the events it receives from the source.

    • Optionally, configuring an enrichment step that enhances the event data before sending it to the target.

    • Specifying one of the supported targets to which you want your pipe to send events.

  2. The event source begins sending events to the pipe, and the pipe processes the event before sending it to the target.

    • If you have configured a filter, the pipe evaluates the event and only sends it to the target if it matches that filter.

      You are only charged for those events that match the filter.

    • If you have configured an enrichment, the pipe performs that enrichment on the event before sending it to the target.

      If the events are batched, the enrichment maintains the ordering of the events in the batch.

A source sends events to a pipe, which filters and routes matching events to the target.

For example, a pipe could be used to create an e-commerce system. Suppose you have an API that contains customer information, such as shipping addresses.

  1. You then create a pipe with the following:

    • An Amazon SQS order received message queue as the event source.

    • An EventBridge API Destination as an enrichment

    • An Amazon Step Functions state machine as the target

  2. Then, when an Amazon SQS order received message appears in the queue, it is sent to your pipe.

  3. The pipe then sends that data to the EventBridge API Destination enrichment, which returns the customer information for that order.

  4. Lastly, the pipe sends the enriched data to the Amazon Step Functions state machine, which processes the order.