Package software.amazon.awscdk.services.events.targets

Interface SnsTopicProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable, TargetBaseProps

All Known Implementing Classes:

SnsTopicProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-12-01T16:02:21.282Z")
@Stability(Stable)
public interface SnsTopicProps
extends software.amazon.jsii.JsiiSerializable, TargetBaseProps

Customize the SNS Topic Event Target.

Example:

 Rule onCommitRule;
 Topic topic;
 onCommitRule.addTarget(SnsTopic.Builder.create(topic)
         .message(RuleTargetInput.fromObject(Map.of(
                 "DataType", String.format("custom_%s", EventField.fromPath("$.detail-type")))))
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static SnsTopicProps.Builder	builder()
default Boolean	getAuthorizeUsingRole()	Specifies whether an IAM role should be used to publish to the topic.
default RuleTargetInput	getMessage()	The message to send to the topic.
default IRole	getRole()	The IAM role to be used to publish to the topic.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Methods inherited from interface software.amazon.awscdk.services.events.targets.TargetBaseProps

getDeadLetterQueue, getMaxEventAge, getRetryAttempts

Method Details

getAuthorizeUsingRole

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

Specifies whether an IAM role should be used to publish to the topic.

Default: - true if `role` is provided, false otherwise

getMessage

@Stability(Stable)
@Nullable
default RuleTargetInput getMessage()

The message to send to the topic.

Default: the entire EventBridge event

getRole

@Stability(Stable)
@Nullable
default IRole getRole()

The IAM role to be used to publish to the topic.

Default: - a new role will be created if `authorizeUsingRole` is true

builder

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

Returns:

a SnsTopicProps.Builder of SnsTopicProps