Skip navigation links

Package software.amazon.awscdk.services.events.targets

Event Targets for Amazon EventBridge

See: Description

Package software.amazon.awscdk.services.events.targets Description

Event Targets for Amazon EventBridge

---

cdk-constructs: Stable

This library contains integration classes to send Amazon EventBridge to any number of supported AWS Services. Instances of these classes should be passed to the rule.addTarget() method.

Currently supported are:

See the README of the @aws-cdk/aws-events library for more information on EventBridge.

Event retry policy and using dead-letter queues

The Codebuild, CodePipeline, Lambda, StepFunctions and LogGroup targets support attaching a dead letter queue and setting retry policies. See the lambda example. Use escape hatches for the other target types.

Invoke a Lambda function

Use the LambdaFunction target to invoke a lambda function.

The code snippet below creates an event rule with a Lambda function as a target triggered for every events from aws.ec2 source. You can optionally attach a dead letter queue. 

 // Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
 import software.amazon.awscdk.aws_lambda;
 import software.amazon.awscdk.aws_events;
 import software.amazon.awscdk.aws_sqs;
 import software.amazon.awscdk.aws_events_targets;
 import software.amazon.awscdk.*;
 
 
 Function fn = new Function(this, "MyFunc", new FunctionProps()
         .runtime(lambda.Runtime.getNODEJS_12_X())
         .handler("index.handler")
         .code(lambda.Code.fromInline(String.format("exports.handler = %s", handler.toString()))));
 
 Rule rule = new Rule(this, "rule", new RuleProps()
         .eventPattern(new EventPattern()
                 .source(asList("aws.ec2"))));
 
 Queue queue = new Queue(this, "Queue");
 
 rule.addTarget(new LambdaFunction(fn, new LambdaFunctionProps()
         .deadLetterQueue(queue)// Optional: add a dead letter queue
         .maxEventAge(cdk.Duration.hours(2))// Otional: set the maxEventAge retry policy
         .retryAttempts(2)));

Log an event into a LogGroup

Use the LogGroup target to log your events in a CloudWatch LogGroup.

For example, the following code snippet creates an event rule with a CloudWatch LogGroup as a target. Every events sent from the aws.ec2 source will be sent to the CloudWatch LogGroup. 

 // Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
 import software.amazon.awscdk.aws_logs;
 import software.amazon.awscdk.aws_events;
 import software.amazon.awscdk.aws_events_targets;
 
 
 LogGroup logGroup = new LogGroup(this, "MyLogGroup", new LogGroupProps()
         .logGroupName("MyLogGroup"));
 
 Rule rule = new Rule(this, "rule", new RuleProps()
         .eventPattern(new EventPattern()
                 .source(asList("aws.ec2"))));
 
 rule.addTarget(new CloudWatchLogGroup(logGroup));

Start a CodeBuild build

Use the CodeBuildProject target to trigger a CodeBuild project.

The code snippet below creates a CodeCommit repository that triggers a CodeBuild project on commit to the master branch. You can optionally attach a dead letter queue. 

 // Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
 import aws.sdk.aws.codebuild.*;
 import aws.sdk.aws.codecommit.*;
 import aws.sdk.aws.sqs.*;
 import software.amazon.awscdk.aws_events_targets;
 
 
 Object repo = Repository.Builder.create(this, "MyRepo")
         .repositoryName("aws-cdk-codebuild-events")
         .build();
 
 Object project = Project.Builder.create(this, "MyProject")
         .source(codebuild.Source.codeCommit(Map.of("repository", repo)))
         .build();
 
 Object deadLetterQueue = new Queue(this, "DeadLetterQueue");
 
 // trigger a build when a commit is pushed to the repo
 Object onCommitRule = repo.onCommit("OnCommit", Map.of(
         "target", new CodeBuildProject(project, new CodeBuildProjectProps()
                 .deadLetterQueue(deadLetterQueue)),
         "branches", asList("master")));

Start a CodePipeline pipeline

Use the CodePipeline target to trigger a CodePipeline pipeline.

The code snippet below creates a CodePipeline pipeline that is triggered every hour 

 // Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
 import aws.sdk.aws.codepipeline.*;
 import aws.sdk.aws.sqs.*;
 
 
 Object pipeline = new Pipeline(this, "Pipeline");
 
 Object rule = Rule.Builder.create(stack, "Rule")
         .schedule(events.Schedule.expression("rate(1 hour)"))
         .build();
 
 rule.addTarget(new CodePipeline(pipeline));

Start a StepFunctions state machine

Use the SfnStateMachine target to trigger a State Machine.

The code snippet below creates a Simple StateMachine that is triggered every minute with a dummy object as input. You can optionally attach a dead letter queue to the target. 

 // Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
 import aws.sdk.aws.iam.*;
 import aws.sdk.aws.sqs.*;
 import software.amazon.awscdk.aws_stepfunctions;
 import software.amazon.awscdk.aws_events_targets;
 
 
 Object rule = Rule.Builder.create(stack, "Rule")
         .schedule(events.Schedule.rate(cdk.Duration.minutes(1)))
         .build();
 
 Object dlq = new Queue(stack, "DeadLetterQueue");
 
 Object role = Role.Builder.create(stack, "Role")
         .assumedBy(new ServicePrincipal("events.amazonaws.com"))
         .build();
 StateMachine stateMachine = new StateMachine(stack, "SM", new StateMachineProps()
         .definition(new Wait(stack, "Hello", new WaitProps().time(sfn.WaitTime.duration(cdk.Duration.seconds(10)))))
         .role(role));
 
 rule.addTarget(new SfnStateMachine(stateMachine, new SfnStateMachineProps()
         .input(events.RuleTargetInput.fromObject(Map.of("SomeParam", "SomeValue")))
         .deadLetterQueue(dlq)));

Invoke a API Gateway REST API

Use the ApiGateway target to trigger a REST API.

The code snippet below creates a Api Gateway REST API that is invoked every hour. 

 // Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
 import aws.sdk.aws.iam.*;
 import aws.sdk.aws.sqs.*;
 import software.amazon.awscdk.aws_apigateway;
 import software.amazon.awscdk.aws_events_targets;
 
 
 Object rule = Rule.Builder.create(stack, "Rule")
         .schedule(events.Schedule.rate(cdk.Duration.minutes(1)))
         .build();
 
 Function fn = new Function(this, "MyFunc", new FunctionProps()
         .handler("index.handler")
         .runtime(lambda.Runtime.getNODEJS_12_X())
         .code(lambda.Code.fromInline("exports.handler = e => {}")));
 
 LambdaRestApi restApi = new LambdaRestApi(this, "MyRestAPI", new LambdaRestApiProps().handler(fn));
 
 Object dlq = new Queue(stack, "DeadLetterQueue");
 
 rule.addTarget(
 new ApiGateway(restApi, new ApiGatewayProps()
         .path("/* /test")
         .mehod("GET")
         .stage("prod")
         .pathParameterValues(asList("path-value"))
         .headerParameters(Map.of(
                 "Header1", "header1"))
         .queryStringParameters(Map.of(
                 "QueryParam1", "query-param-1"))
         .deadLetterQueue(queue)));
Skip navigation links

Copyright © 2021. All rights reserved.