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

Class CfnSubscriptionPropsMixin.Builder

java.lang.Object

software.amazon.awscdk.cfnpropertymixins.services.sns.CfnSubscriptionPropsMixin.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<CfnSubscriptionPropsMixin>

Enclosing class:

CfnSubscriptionPropsMixin

@Stability(Stable)
public static final class CfnSubscriptionPropsMixin.Builder
extends Object
implements software.amazon.jsii.Builder<CfnSubscriptionPropsMixin>

A fluent builder for CfnSubscriptionPropsMixin.

Method Summary

Modifier and Type	Method	Description
CfnSubscriptionPropsMixin	build()
static CfnSubscriptionPropsMixin.Builder	create()
static CfnSubscriptionPropsMixin.Builder	create(CfnPropertyMixinOptions options)
CfnSubscriptionPropsMixin.Builder	deliveryPolicy(Object deliveryPolicy)	The delivery policy JSON assigned to the subscription.
CfnSubscriptionPropsMixin.Builder	endpoint(String endpoint)	The subscription's endpoint.
CfnSubscriptionPropsMixin.Builder	endpoint(IDeliveryStreamRef endpoint)	The subscription's endpoint.
CfnSubscriptionPropsMixin.Builder	endpoint(IFunctionRef endpoint)	The subscription's endpoint.
CfnSubscriptionPropsMixin.Builder	endpoint(IVersionRef endpoint)	The subscription's endpoint.
CfnSubscriptionPropsMixin.Builder	endpoint(IQueueRef endpoint)	The subscription's endpoint.
CfnSubscriptionPropsMixin.Builder	filterPolicy(Object filterPolicy)	The filter policy JSON assigned to the subscription.
CfnSubscriptionPropsMixin.Builder	filterPolicyScope(String filterPolicyScope)	This attribute lets you choose the filtering scope by using one of the following string value types:.
CfnSubscriptionPropsMixin.Builder	protocol(String protocol)	The subscription's protocol.
CfnSubscriptionPropsMixin.Builder	rawMessageDelivery(Boolean rawMessageDelivery)	When set to true , enables raw message delivery.
CfnSubscriptionPropsMixin.Builder	rawMessageDelivery(IResolvable rawMessageDelivery)	When set to true , enables raw message delivery.
CfnSubscriptionPropsMixin.Builder	redrivePolicy(Object redrivePolicy)	When specified, sends undeliverable messages to the specified Amazon SQS dead-letter queue.
CfnSubscriptionPropsMixin.Builder	region(String region)	For cross-region subscriptions, the region in which the topic resides.
CfnSubscriptionPropsMixin.Builder	replayPolicy(Object replayPolicy)	Specifies whether Amazon resends the notification to the subscription when a message's attribute changes.
CfnSubscriptionPropsMixin.Builder	subscriptionRoleArn(String subscriptionRoleArn)	This property applies only to Amazon Data Firehose delivery stream subscriptions.
CfnSubscriptionPropsMixin.Builder	subscriptionRoleArn(IRoleRef subscriptionRoleArn)	This property applies only to Amazon Data Firehose delivery stream subscriptions.
CfnSubscriptionPropsMixin.Builder	topicArn(String topicArn)	The ARN of the topic to subscribe to.
CfnSubscriptionPropsMixin.Builder	topicArn(ITopicRef topicArn)	The ARN of the topic to subscribe to.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

create

@Stability(Stable)
public static CfnSubscriptionPropsMixin.Builder create(CfnPropertyMixinOptions options)

Parameters:

options - Mixin options.

Returns:

a new instance of CfnSubscriptionPropsMixin.Builder.

create

@Stability(Stable)
public static CfnSubscriptionPropsMixin.Builder create()

Returns:

a new instance of CfnSubscriptionPropsMixin.Builder.

deliveryPolicy

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder deliveryPolicy(Object deliveryPolicy)

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 .

Parameters:

deliveryPolicy - The delivery policy JSON assigned to the subscription. This parameter is required.

Returns:

this

See Also:

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

endpoint

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder endpoint(String endpoint)

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 .

Parameters:

endpoint - The subscription's endpoint. This parameter is required.

Returns:

this

See Also:

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

endpoint

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder endpoint(IDeliveryStreamRef endpoint)

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 .

Parameters:

endpoint - The subscription's endpoint. This parameter is required.

Returns:

this

See Also:

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

endpoint

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder endpoint(IFunctionRef endpoint)

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 .

Parameters:

endpoint - The subscription's endpoint. This parameter is required.

Returns:

this

See Also:

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

endpoint

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder endpoint(IVersionRef endpoint)

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 .

Parameters:

endpoint - The subscription's endpoint. This parameter is required.

Returns:

this

See Also:

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

endpoint

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder endpoint(IQueueRef endpoint)

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 .

Parameters:

endpoint - The subscription's endpoint. This parameter is required.

Returns:

this

See Also:

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

filterPolicy

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder filterPolicy(Object filterPolicy)

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 .

Parameters:

filterPolicy - The filter policy JSON assigned to the subscription. This parameter is required.

Returns:

this

See Also:

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

filterPolicyScope

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder filterPolicyScope(String filterPolicyScope)

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.

Parameters:

filterPolicyScope - This attribute lets you choose the filtering scope by using one of the following string value types:. This parameter is required.

Returns:

this

See Also:

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

protocol

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder protocol(String protocol)

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 .

Parameters:

protocol - The subscription's protocol. This parameter is required.

Returns:

this

See Also:

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

rawMessageDelivery

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder rawMessageDelivery(Boolean rawMessageDelivery)

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 .

Parameters:

rawMessageDelivery - When set to true , enables raw message delivery. This parameter is required.

Returns:

this

See Also:

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

rawMessageDelivery

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder rawMessageDelivery(IResolvable rawMessageDelivery)

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 .

Parameters:

rawMessageDelivery - When set to true , enables raw message delivery. This parameter is required.

Returns:

this

See Also:

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

redrivePolicy

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder redrivePolicy(Object redrivePolicy)

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 .

Parameters:

redrivePolicy - When specified, sends undeliverable messages to the specified Amazon SQS dead-letter queue. This parameter is required.

Returns:

this

See Also:

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

region

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder region(String region)

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 .

Parameters:

region - For cross-region subscriptions, the region in which the topic resides. This parameter is required.

Returns:

this

See Also:

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

replayPolicy

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder replayPolicy(Object replayPolicy)

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

Parameters:

replayPolicy - Specifies whether Amazon resends the notification to the subscription when a message's attribute changes. This parameter is required.

Returns:

this

See Also:

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

subscriptionRoleArn

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder subscriptionRoleArn(String subscriptionRoleArn)

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.

Parameters:

subscriptionRoleArn - This property applies only to Amazon Data Firehose delivery stream subscriptions. This parameter is required.

Returns:

this

See Also:

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

subscriptionRoleArn

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder subscriptionRoleArn(IRoleRef subscriptionRoleArn)

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.

Parameters:

subscriptionRoleArn - This property applies only to Amazon Data Firehose delivery stream subscriptions. This parameter is required.

Returns:

this

See Also:

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

topicArn

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder topicArn(String topicArn)

The ARN of the topic to subscribe to.

Parameters:

topicArn - The ARN of the topic to subscribe to. This parameter is required.

Returns:

this

See Also:

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

topicArn

@Stability(Stable)
public CfnSubscriptionPropsMixin.Builder topicArn(ITopicRef topicArn)

The ARN of the topic to subscribe to.

Parameters:

topicArn - The ARN of the topic to subscribe to. This parameter is required.

Returns:

this

See Also:

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

build

@Stability(Stable)
public CfnSubscriptionPropsMixin build()

Specified by:

build in interface software.amazon.jsii.Builder<CfnSubscriptionPropsMixin>

Returns:

a newly built instance of CfnSubscriptionPropsMixin.