software.amazon.awscdk.services.events

Interface OnEventOptions

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.73.0 (build 6faeda3)",
           date="2023-01-31T18:36:51.445Z")
public interface OnEventOptions

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 java.lang.String	getDescription() A description of the rule's purpose.
default EventPattern	getEventPattern() Additional restrictions for the event to route to the specified target.
default java.lang.String	getRuleName() A name for the rule.
default IRuleTarget	getTarget() The target to register for the event.

Method Detail

getDescription

default java.lang.String getDescription()

A description of the rule's purpose.

Default: - No description

getEventPattern

default EventPattern getEventPattern()

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

default java.lang.String getRuleName()

A name for the rule.

Default: AWS CloudFormation generates a unique physical ID.

getTarget

default IRuleTarget getTarget()

The target to register for the event.

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

builder

static OnEventOptions.Builder builder()

Returns:

a OnEventOptions.Builder of OnEventOptions