software.amazon.awscdk.services.events

Interface RuleProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

RuleProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-04T15:39:09.058Z")
 @Stability(value=Experimental)
public interface RuleProps
extends software.amazon.jsii.JsiiSerializable

(experimental) Properties for defining an EventBridge Rule.

Example:

 import software.amazon.awscdk.core.*;
 Function fn = Function.Builder.create(this, "MyFunc")
         .runtime(Runtime.NODEJS_12_X)
         .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 and Description
static class	RuleProps.Builder A builder for RuleProps
static class	RuleProps.Jsii$Proxy An implementation for RuleProps

Method Summary

Modifier and Type	Method and Description
static RuleProps.Builder	builder()
default String	getDescription() (experimental) A description of the rule's purpose.
default Boolean	getEnabled() (experimental) Indicates whether the rule is enabled.
default IEventBus	getEventBus() (experimental) The event bus to associate with this rule.
default EventPattern	getEventPattern() (experimental) Describes which events EventBridge routes to the specified target.
default String	getRuleName() (experimental) A name for the rule.
default Schedule	getSchedule() (experimental) The schedule or rate (frequency) that determines when EventBridge runs the rule.
default List<IRuleTarget>	getTargets() (experimental) Targets to invoke when this rule matches an event.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getDescription

@Stability(value=Experimental)
 @Nullable
default String getDescription()

(experimental) A description of the rule's purpose.

Default: - No description.

getEnabled

@Stability(value=Experimental)
 @Nullable
default Boolean getEnabled()

(experimental) Indicates whether the rule is enabled.

Default: true

getEventBus

@Stability(value=Experimental)
 @Nullable
default IEventBus getEventBus()

(experimental) The event bus to associate with this rule.

Default: - The default event bus.

getEventPattern

@Stability(value=Experimental)
 @Nullable
default EventPattern getEventPattern()

(experimental) Describes which events EventBridge routes to the specified target.

These routed events are matched events. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.

Default: - None.

See Also:

You must specify this property (either via props or via `addEventPattern`), the `scheduleExpression` property, or both. The method `addEventPattern` can be used to add filter values to the event pattern.

getRuleName

@Stability(value=Experimental)
 @Nullable
default String getRuleName()

(experimental) A name for the rule.

Default: - AWS CloudFormation generates a unique physical ID and uses that ID for the rule name. For more information, see Name Type.

getSchedule

@Stability(value=Experimental)
 @Nullable
default Schedule getSchedule()

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

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

Default: - None.

See Also:

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

getTargets

@Stability(value=Experimental)
 @Nullable
default List<IRuleTarget> getTargets()

(experimental) 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(value=Experimental)
static RuleProps.Builder builder()

Returns:

a RuleProps.Builder of RuleProps