Package software.amazon.awscdk.services.events

Interface RuleProps

All Superinterfaces:

EventCommonOptions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

RuleProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.97.0 (build 729de35)",
           date="2024-04-24T21:00:30.181Z")
@Stability(Stable)
public interface RuleProps
extends software.amazon.jsii.JsiiSerializable, EventCommonOptions

Properties for defining an EventBridge Rule.

Example:

 import software.amazon.awscdk.services.lambda.*;
 Function fn = Function.Builder.create(this, "MyFunc")
         .runtime(Runtime.NODEJS_LATEST)
         .handler("index.handler")
         .code(Code.fromInline("exports.handler = handler.toString()"))
         .build();
 Rule rule = Rule.Builder.create(this, "rule")
         .eventPattern(EventPattern.builder()
                 .source(List.of("aws.ec2"))
                 .build())
         .build();
 Queue queue = new Queue(this, "Queue");
 rule.addTarget(LambdaFunction.Builder.create(fn)
         .deadLetterQueue(queue) // Optional: add a dead letter queue
         .maxEventAge(Duration.hours(2)) // Optional: set the maxEventAge retry policy
         .retryAttempts(2)
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	RuleProps.Builder	A builder for RuleProps
static final class	RuleProps.Jsii$Proxy	An implementation for RuleProps

Method Summary

Modifier and Type	Method	Description
static RuleProps.Builder	builder()
default Boolean	getEnabled()	Indicates whether the rule is enabled.
default IEventBus	getEventBus()	The event bus to associate with this rule.
default Schedule	getSchedule()	The schedule or rate (frequency) that determines when EventBridge runs the rule.
default List<IRuleTarget>	getTargets()	Targets to invoke when this rule matches an event.

Methods inherited from interface software.amazon.awscdk.services.events.EventCommonOptions

getCrossStackScope, getDescription, getEventPattern, getRuleName

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getEnabled

@Stability(Stable)
@Nullable
default Boolean getEnabled()

Indicates whether the rule is enabled.

Default: true

getEventBus

@Stability(Stable)
@Nullable
default IEventBus getEventBus()

The event bus to associate with this rule.

Default: - The default event bus.

getSchedule

@Stability(Stable)
@Nullable
default Schedule getSchedule()

The schedule or rate (frequency) that determines when EventBridge runs the rule.

You must specify this property, the eventPattern property, or both.

For more information, see Schedule Expression Syntax for Rules in the Amazon EventBridge User Guide.

Default: - None.

See Also:

• https://docs.aws.amazon.com/eventbridge/latest/userguide/scheduled-events.html

getTargets

@Stability(Stable)
@Nullable
default List<IRuleTarget> getTargets()

Targets to invoke when this rule matches an event.

Input will be the full matched event. If you wish to specify custom target input, use addTarget(target[, inputOptions]).

Default: - No targets.

builder

@Stability(Stable)
static RuleProps.Builder builder()

Returns:

a RuleProps.Builder of RuleProps