software.amazon.awscdk.services.events

Interface OnEventOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

OnCloudTrailBucketEventOptions, OnCloudTrailImagePushedOptions, OnCommitOptions, OnImageScanCompletedOptions

All Known Implementing Classes:

OnCloudTrailBucketEventOptions.Jsii$Proxy, OnCloudTrailImagePushedOptions.Jsii$Proxy, OnCommitOptions.Jsii$Proxy, OnEventOptions.Jsii$Proxy, OnImageScanCompletedOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.70.0 (build 03c2f6f)",
           date="2022-11-01T13:16:48.969Z")
 @Stability(value=Experimental)
public interface OnEventOptions
extends software.amazon.jsii.JsiiSerializable

(experimental) Standard set of options for `onXxx` event handlers on construct.

Example:

 // Lambda function containing logic that evaluates compliance with the rule.
 Function evalComplianceFn = Function.Builder.create(this, "CustomFunction")
         .code(AssetCode.fromInline("exports.handler = (event) => console.log(event);"))
         .handler("index.handler")
         .runtime(Runtime.NODEJS_14_X)
         .build();
 // A custom rule that runs on configuration changes of EC2 instances
 CustomRule customRule = CustomRule.Builder.create(this, "Custom")
         .configurationChanges(true)
         .lambdaFunction(evalComplianceFn)
         .ruleScope(RuleScope.fromResource(ResourceType.EC2_INSTANCE))
         .build();
 // A rule to detect stack drifts
 CloudFormationStackDriftDetectionCheck driftRule = new CloudFormationStackDriftDetectionCheck(this, "Drift");
 // Topic to which compliance notification events will be published
 Topic complianceTopic = new Topic(this, "ComplianceTopic");
 // Send notification on compliance change events
 driftRule.onComplianceChange("ComplianceChange", OnEventOptions.builder()
         .target(new SnsTopic(complianceTopic))
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static OnEventOptions.Builder	builder()
default String	getDescription() (experimental) A description of the rule's purpose.
default EventPattern	getEventPattern() (experimental) Additional restrictions for the event to route to the specified target.
default String	getRuleName() (experimental) A name for the rule.
default IRuleTarget	getTarget() (experimental) The target to register for the 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

getEventPattern

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

(experimental) Additional restrictions for the event to route to the specified target.

The method that generates the rule probably imposes some type of event filtering. The filtering implied by what you pass here is added on top of that filtering.

Default: - No additional filtering based on an event pattern.

See Also:

https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html

getRuleName

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

(experimental) A name for the rule.

Default: AWS CloudFormation generates a unique physical ID.

getTarget

@Stability(value=Experimental)
 @Nullable
default IRuleTarget getTarget()

(experimental) The target to register for the event.

Default: - No target is added to the rule. Use `addTarget()` to add a target.

builder

@Stability(value=Experimental)
static OnEventOptions.Builder builder()

Returns:

a OnEventOptions.Builder of OnEventOptions