software.amazon.awscdk.services.sns

Interface SubscriptionOptions

All Known Subinterfaces:

SubscriptionProps, TopicSubscriptionConfig

All Known Implementing Classes:

SubscriptionOptions.Jsii$Proxy, SubscriptionProps.Jsii$Proxy, TopicSubscriptionConfig.Jsii$Proxy

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:42.103Z")
public interface SubscriptionOptions

Options for creating a new subscription.

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.sqs.*;
 Queue queue;
 SubscriptionFilter subscriptionFilter;
 SubscriptionOptions subscriptionOptions = SubscriptionOptions.builder()
         .endpoint("endpoint")
         .protocol(SubscriptionProtocol.HTTP)
         // the properties below are optional
         .deadLetterQueue(queue)
         .filterPolicy(Map.of(
                 "filterPolicyKey", subscriptionFilter))
         .rawMessageDelivery(false)
         .region("region")
         .subscriptionRoleArn("subscriptionRoleArn")
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static SubscriptionOptions.Builder	builder()
default IQueue	getDeadLetterQueue() Queue to be used as dead letter queue.
java.lang.String	getEndpoint() The subscription endpoint.
default java.util.Map<java.lang.String,SubscriptionFilter>	getFilterPolicy() The filter policy.
SubscriptionProtocol	getProtocol() What type of subscription to add.
default java.lang.Boolean	getRawMessageDelivery() true if raw message delivery is enabled for the subscription.
default java.lang.String	getRegion() The region where the topic resides, in the case of cross-region subscriptions.
default java.lang.String	getSubscriptionRoleArn() Arn of role allowing access to firehose delivery stream.

Method Detail

getEndpoint

java.lang.String getEndpoint()

The subscription endpoint.

The meaning of this value depends on the value for 'protocol'.

getProtocol

SubscriptionProtocol getProtocol()

What type of subscription to add.

getDeadLetterQueue

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

default java.util.Map<java.lang.String,SubscriptionFilter> getFilterPolicy()

The filter policy.

Default: - all messages are delivered

getRawMessageDelivery

default java.lang.Boolean getRawMessageDelivery()

true if raw message delivery is enabled for the subscription.

Raw messages are free of JSON formatting and can be sent to HTTP/S and Amazon SQS endpoints. For more information, see GetSubscriptionAttributes in the Amazon Simple Notification Service API Reference.

Default: false

getRegion

default java.lang.String getRegion()

The region where the topic resides, in the case of cross-region subscriptions.

Default: - the region where the CloudFormation stack is being deployed.

getSubscriptionRoleArn

default java.lang.String getSubscriptionRoleArn()

Arn of role allowing access to firehose delivery stream.

Required for a firehose subscription protocol.

Default: - No subscription role is provided

builder

static SubscriptionOptions.Builder builder()

Returns:

a SubscriptionOptions.Builder of SubscriptionOptions