Package software.amazon.awscdk.cfnpropertymixins.services.sns

Interface CfnSubscriptionMixinProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnSubscriptionMixinProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.127.0 (build 2117ad5)",
           date="2026-03-11T13:20:05.642Z")
@Stability(Stable)
public interface CfnSubscriptionMixinProps
extends software.amazon.jsii.JsiiSerializable

Properties for CfnSubscriptionPropsMixin.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.cfnpropertymixins.services.sns.*;
 Object deliveryPolicy;
 Object filterPolicy;
 Object redrivePolicy;
 Object replayPolicy;
 CfnSubscriptionMixinProps cfnSubscriptionMixinProps = CfnSubscriptionMixinProps.builder()
         .deliveryPolicy(deliveryPolicy)
         .endpoint("endpoint")
         .filterPolicy(filterPolicy)
         .filterPolicyScope("filterPolicyScope")
         .protocol("protocol")
         .rawMessageDelivery(false)
         .redrivePolicy(redrivePolicy)
         .region("region")
         .replayPolicy(replayPolicy)
         .subscriptionRoleArn("subscriptionRoleArn")
         .topicArn("topicArn")
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static CfnSubscriptionMixinProps.Builder	builder()
default Object	getDeliveryPolicy()	The delivery policy JSON assigned to the subscription.
default Object	getEndpoint()	The subscription's endpoint.
default Object	getFilterPolicy()	The filter policy JSON assigned to the subscription.
default String	getFilterPolicyScope()	This attribute lets you choose the filtering scope by using one of the following string value types:.
default String	getProtocol()	The subscription's protocol.
default Object	getRawMessageDelivery()	When set to true , enables raw message delivery.
default Object	getRedrivePolicy()	When specified, sends undeliverable messages to the specified Amazon SQS dead-letter queue.
default String	getRegion()	For cross-region subscriptions, the region in which the topic resides.
default Object	getReplayPolicy()	Specifies whether Amazon resends the notification to the subscription when a message's attribute changes.
default Object	getSubscriptionRoleArn()	This property applies only to Amazon Data Firehose delivery stream subscriptions.
default Object	getTopicArn()	The ARN of the topic to subscribe to.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getDeliveryPolicy

@Stability(Stable)
@Nullable
default Object getDeliveryPolicy()

The delivery policy JSON assigned to the subscription.

Enables the subscriber to define the message delivery retry strategy in the case of an HTTP/S endpoint subscribed to the topic. For more information, see [GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html) in the Amazon API Reference and Message delivery retries in the Amazon Developer Guide .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-deliverypolicy

getEndpoint

@Stability(Stable)
@Nullable
default Object getEndpoint()

The subscription's endpoint.

The endpoint value depends on the protocol that you specify. For more information, see the Endpoint parameter of the [Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html) action in the Amazon API Reference .

Returns union: either String or IDeliveryStreamRef or IFunctionRef or IVersionRef or IQueueRef

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-endpoint

getFilterPolicy

@Stability(Stable)
@Nullable
default Object getFilterPolicy()

The filter policy JSON assigned to the subscription.

Enables the subscriber to filter out unwanted messages. For more information, see [GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html) in the Amazon API Reference and Message filtering in the Amazon Developer Guide .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicy

getFilterPolicyScope

@Stability(Stable)
@Nullable
default String getFilterPolicyScope()

This attribute lets you choose the filtering scope by using one of the following string value types:.

• MessageAttributes (default) - The filter is applied on the message attributes.
• MessageBody - The filter is applied on the message body.

Null is not a valid value for FilterPolicyScope . To delete a filter policy, delete the FilterPolicy property but keep FilterPolicyScope property as is.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-filterpolicyscope

getProtocol

@Stability(Stable)
@Nullable
default String getProtocol()

The subscription's protocol.

For more information, see the Protocol parameter of the [Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html) action in the Amazon API Reference .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-protocol

getRawMessageDelivery

@Stability(Stable)
@Nullable
default Object getRawMessageDelivery()

When set to true , enables raw message delivery.

Raw messages don't contain any JSON formatting and can be sent to Amazon SQS and HTTP/S endpoints. For more information, see [GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html) in the Amazon API Reference .

Returns union: either Boolean or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-rawmessagedelivery

getRedrivePolicy

@Stability(Stable)
@Nullable
default Object getRedrivePolicy()

When specified, sends undeliverable messages to the specified Amazon SQS dead-letter queue.

Messages that can't be delivered due to client errors (for example, when the subscribed endpoint is unreachable) or server errors (for example, when the service that powers the subscribed endpoint becomes unavailable) are held in the dead-letter queue for further analysis or reprocessing.

For more information about the redrive policy and dead-letter queues, see Amazon SQS dead-letter queues in the Amazon SQS Developer Guide .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-redrivepolicy

getRegion

@Stability(Stable)
@Nullable
default String getRegion()

For cross-region subscriptions, the region in which the topic resides.

If no region is specified, CloudFormation uses the region of the caller as the default.

If you perform an update operation that only updates the Region property of a AWS::SNS::Subscription resource, that operation will fail unless you are either:

• Updating the Region from NULL to the caller region.
• Updating the Region from the caller region to NULL .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-region

getReplayPolicy

@Stability(Stable)
@Nullable
default Object getReplayPolicy()

Specifies whether Amazon resends the notification to the subscription when a message's attribute changes.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-replaypolicy

getSubscriptionRoleArn

@Stability(Stable)
@Nullable
default Object getSubscriptionRoleArn()

This property applies only to Amazon Data Firehose delivery stream subscriptions.

Specify the ARN of the IAM role that has the following:

• Permission to write to the Amazon Data Firehose delivery stream
• Amazon listed as a trusted entity

Specifying a valid ARN for this attribute is required for Firehose delivery stream subscriptions. For more information, see Fanout to Amazon Data Firehose delivery streams in the Amazon Developer Guide.

Returns union: either String or IRoleRef

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-subscriptionrolearn

getTopicArn

@Stability(Stable)
@Nullable
default Object getTopicArn()

The ARN of the topic to subscribe to.

Returns union: either String or ITopicRef

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-subscription.html#cfn-sns-subscription-topicarn

builder

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

Returns:

a CfnSubscriptionMixinProps.Builder of CfnSubscriptionMixinProps