Package software.amazon.awscdk.services.sns.subscriptions

Interface SubscriptionProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

EmailSubscriptionProps, FirehoseSubscriptionProps, LambdaSubscriptionProps, SmsSubscriptionProps, SnsEventSourceProps, SqsSubscriptionProps, UrlSubscriptionProps

All Known Implementing Classes:

EmailSubscriptionProps.Jsii$Proxy, FirehoseSubscriptionProps.Jsii$Proxy, LambdaSubscriptionProps.Jsii$Proxy, SmsSubscriptionProps.Jsii$Proxy, SnsEventSourceProps.Jsii$Proxy, SqsSubscriptionProps.Jsii$Proxy, SubscriptionProps.Jsii$Proxy, UrlSubscriptionProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)",
           date="2025-10-24T13:34:47.547Z")
@Stability(Stable)
public interface SubscriptionProps
extends software.amazon.jsii.JsiiSerializable

Options to subscribing to an SNS topic.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.sns.*;
 import software.amazon.awscdk.services.sns.subscriptions.*;
 import software.amazon.awscdk.services.sqs.*;
 FilterOrPolicy filterOrPolicy;
 Queue queue;
 SubscriptionFilter subscriptionFilter;
 SubscriptionProps subscriptionProps = SubscriptionProps.builder()
         .deadLetterQueue(queue)
         .filterPolicy(Map.of(
                 "filterPolicyKey", subscriptionFilter))
         .filterPolicyWithMessageBody(Map.of(
                 "filterPolicyWithMessageBodyKey", filterOrPolicy))
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static SubscriptionProps.Builder	builder()
default IQueue	getDeadLetterQueue()	Queue to be used as dead letter queue.
default Map<String,SubscriptionFilter>	getFilterPolicy()	The filter policy.
default Map<String,FilterOrPolicy>	getFilterPolicyWithMessageBody()	The filter policy that is applied on the message body.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getDeadLetterQueue

@Stability(Stable)
@Nullable
default IQueue getDeadLetterQueue()

Queue to be used as dead letter queue.

If not passed no dead letter queue is enabled.

Default: - No dead letter queue enabled.

getFilterPolicy

@Stability(Stable)
@Nullable
default Map<String,SubscriptionFilter> getFilterPolicy()

The filter policy.

Default: - all messages are delivered

getFilterPolicyWithMessageBody

@Stability(Stable)
@Nullable
default Map<String,FilterOrPolicy> getFilterPolicyWithMessageBody()

The filter policy that is applied on the message body.

To apply a filter policy to the message attributes, use filterPolicy. A maximum of one of filterPolicyWithMessageBody and filterPolicy may be used.

Default: - all messages are delivered

builder

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

Returns:

a SubscriptionProps.Builder of SubscriptionProps