Package software.amazon.awscdk.services.sns.subscriptions
CDK Construct Library for Amazon Simple Notification Service Subscriptions
This library provides constructs for adding subscriptions to an Amazon SNS topic.
Subscriptions can be added by calling the .addSubscription(...)
method on the topic.
Subscriptions
Subscriptions can be added to the following endpoints:
- HTTPS
- Amazon SQS
- AWS Lambda
- SMS
Subscriptions to Amazon SQS and AWS Lambda can be added on topics across regions.
Create an Amazon SNS Topic to add subscriptions.
Topic myTopic = new Topic(this, "MyTopic");
HTTPS
Add an HTTP or HTTPS Subscription to your topic:
Topic myTopic = new Topic(this, "MyTopic"); myTopic.addSubscription(new UrlSubscription("https://foobar.com/"));
The URL being subscribed can also be tokens, that resolve to a URL during deployment. A typical use case is when the URL is passed in as a CloudFormation parameter. The following code defines a CloudFormation parameter and uses it in a URL subscription.
Topic myTopic = new Topic(this, "MyTopic"); CfnParameter url = new CfnParameter(this, "url-param"); myTopic.addSubscription(new UrlSubscription(url.getValueAsString()));
Amazon SQS
Subscribe a queue to your topic:
Queue myQueue = new Queue(this, "MyQueue"); Topic myTopic = new Topic(this, "MyTopic"); myTopic.addSubscription(new SqsSubscription(myQueue));
KMS key permissions will automatically be granted to SNS when a subscription is made to an encrypted queue.
Note that subscriptions of queues in different accounts need to be manually confirmed by reading the initial message from the queue and visiting the link found in it.
AWS Lambda
Subscribe an AWS Lambda function to your topic:
import software.amazon.awscdk.services.lambda.*; Function myFunction; Topic myTopic = new Topic(this, "myTopic"); myTopic.addSubscription(new LambdaSubscription(myFunction));
Subscribe an email address to your topic:
Topic myTopic = new Topic(this, "MyTopic"); myTopic.addSubscription(new EmailSubscription("foo@bar.com"));
The email being subscribed can also be tokens, that resolve to an email address during deployment. A typical use case is when the email address is passed in as a CloudFormation parameter. The following code defines a CloudFormation parameter and uses it in an email subscription.
Topic myTopic = new Topic(this, "Topic"); CfnParameter emailAddress = new CfnParameter(this, "email-param"); myTopic.addSubscription(new EmailSubscription(emailAddress.getValueAsString()));
Note that email subscriptions require confirmation by visiting the link sent to the email address.
SMS
Subscribe an sms number to your topic:
Topic myTopic = new Topic(this, "Topic"); myTopic.addSubscription(new SmsSubscription("+15551231234"));
The number being subscribed can also be tokens, that resolve to a number during deployment. A typical use case is when the number is passed in as a CloudFormation parameter. The following code defines a CloudFormation parameter and uses it in an sms subscription.
Topic myTopic = new Topic(this, "Topic"); CfnParameter smsNumber = new CfnParameter(this, "sms-param"); myTopic.addSubscription(new SmsSubscription(smsNumber.getValueAsString()));
-
ClassDescriptionUse an email address as a subscription target.A fluent builder for
EmailSubscription
.Options for email subscriptions.A builder forEmailSubscriptionProps
An implementation forEmailSubscriptionProps
Use a Lambda function as a subscription target.A fluent builder forLambdaSubscription
.Properties for a Lambda subscription.A builder forLambdaSubscriptionProps
An implementation forLambdaSubscriptionProps
Use an sms address as a subscription target.A fluent builder forSmsSubscription
.Options for SMS subscriptions.A builder forSmsSubscriptionProps
An implementation forSmsSubscriptionProps
Use an SQS queue as a subscription target.A fluent builder forSqsSubscription
.Properties for an SQS subscription.A builder forSqsSubscriptionProps
An implementation forSqsSubscriptionProps
Options to subscribing to an SNS topic.A builder forSubscriptionProps
An implementation forSubscriptionProps
Use a URL as a subscription target.A fluent builder forUrlSubscription
.Options for URL subscriptions.A builder forUrlSubscriptionProps
An implementation forUrlSubscriptionProps