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.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:39.311Z")
 @Stability(value=Stable)
public interface RuleProps
extends software.amazon.jsii.JsiiSerializable, EventCommonOptions

Properties for defining an EventBridge Rule.

Example:

 Connection connection = Connection.Builder.create(this, "Connection")
         .authorization(Authorization.apiKey("x-api-key", SecretValue.secretsManager("ApiSecretName")))
         .description("Connection with API Key x-api-key")
         .build();
 ApiDestination destination = ApiDestination.Builder.create(this, "Destination")
         .connection(connection)
         .endpoint("https://example.com")
         .description("Calling example.com with API key x-api-key")
         .build();
 Rule rule = Rule.Builder.create(this, "Rule")
         .schedule(Schedule.rate(Duration.minutes(1)))
         .targets(List.of(new ApiDestination(destination)))
         .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 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 Detail

getEnabled

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

Indicates whether the rule is enabled.

Default: true

getEventBus

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

The event bus to associate with this rule.

Default: - The default event bus.

getSchedule

@Stability(value=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(value=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(value=Stable)
static RuleProps.Builder builder()

Specified by:

builder in interface EventCommonOptions

Returns:

a RuleProps.Builder of RuleProps