Amazon.CDK.AWS.Pipes.Enrichments.Alpha

Amazon EventBridge Pipes Enrichments Construct Library

The APIs of higher level constructs in this module are experimental and under active development. They are subject to non-backward compatible changes or removal in any future version. These are not subject to the Semantic Versioning model and breaking changes will be announced in the release notes. This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.

EventBridge Pipes Enrichments let you create enrichments for an EventBridge Pipe.

For more details see the service documentation:

Documentation

Pipe sources

Pipe enrichments are invoked prior to sending the events to a target of a EventBridge Pipe.

Lambda function

A Lambda function can be used to enrich events of a pipe.

Queue sourceQueue;
Queue targetQueue;

Function enrichmentFunction;


var enrichment = new LambdaEnrichment(enrichmentFunction);

var pipe = new Pipe(this, "Pipe", new PipeProps {
    Source = new SomeSource(sourceQueue),
    Enrichment = enrichment,
    Target = new SomeTarget(targetQueue)
});

Step Functions state machine

Step Functions state machine can be used to enrich events of a pipe.

Note: EventBridge Pipes only supports Express workflows invoked synchronously.

Visit Amazon EventBridge Pipes event enrichment for more details.

Queue sourceQueue;
Queue targetQueue;

StateMachine enrichmentStateMachine;


var enrichment = new StepFunctionsEnrichment(enrichmentStateMachine);

var pipe = new Pipe(this, "Pipe", new PipeProps {
    Source = new SomeSource(sourceQueue),
    Enrichment = enrichment,
    Target = new SomeTarget(targetQueue)
});

API destination

API destination can be used to enrich events of a pipe.

Queue sourceQueue;
Queue targetQueue;

ApiDestination apiDestination;


var enrichment = new ApiDestinationEnrichment(apiDestination);

var pipe = new Pipe(this, "Pipe", new PipeProps {
    Source = new SomeSource(sourceQueue),
    Enrichment = enrichment,
    Target = new SomeTarget(targetQueue)
});

API Gateway (REST API)

API Gateway can be used to enrich events of a pipe. Pipes only supports API Gateway REST APIs. HTTP APIs are not supported.

Queue sourceQueue;
Queue targetQueue;

RestApi restApi;


var enrichment = new ApiGatewayEnrichment(restApi);

var pipe = new Pipe(this, "Pipe", new PipeProps {
    Source = new SomeSource(sourceQueue),
    Enrichment = enrichment,
    Target = new SomeTarget(targetQueue)
});