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
- Email
- SMS
Subscriptions to Amazon SQS and AWS Lambda can be added on topics across regions.
Create an Amazon SNS Topic to add subscriptions.
import * as sns from '@aws-cdk/aws-sns';
const myTopic = new sns.Topic(this, 'MyTopic');
HTTPS
Add an HTTP or HTTPS Subscription to your topic:
import * as subscriptions from '@aws-cdk/aws-sns-subscriptions';
myTopic.addSubscription(new subscriptions.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.
const url = new CfnParameter(this, 'url-param');
myTopic.addSubscription(new subscriptions.UrlSubscription(url.valueAsString()));
Amazon SQS
Subscribe a queue to your topic:
import * as sqs from '@aws-cdk/aws-sqs';
import * as subscriptions from '@aws-cdk/aws-sns-subscriptions';
const myQueue = new sqs.Queue(this, 'MyQueue');
myTopic.addSubscription(new subscriptions.SqsSubscription(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 * as lambda from '@aws-cdk/aws-lambda';
import * as subscriptions from '@aws-cdk/aws-sns-subscriptions';
const myFunction = new lambda.Function(this, 'Echo', {
handler: 'index.handler',
runtime: lambda.Runtime.NODEJS_12_X,
code: lambda.Code.fromInline(`exports.handler = ${handler.toString()}`)
});
myTopic.addSubscription(new subscriptions.LambdaSubscription(myFunction));
Email
Subscribe an email address to your topic:
import * as subscriptions from '@aws-cdk/aws-sns-subscriptions';
myTopic.addSubscription(new subscriptions.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.
const emailAddress = new CfnParameter(this, 'email-param');
myTopic.addSubscription(new subscriptions.EmailSubscription(emailAddress.valueAsString()));
Note that email subscriptions require confirmation by visiting the link sent to the
email address.
SMS
Subscribe an sms number to your topic:
import * as subscriptions from '@aws-cdk/aws-sns-subscriptions';
myTopic.addSubscription(new subscriptions.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.
const smsNumber = new CfnParameter(this, 'sms-param');
myTopic.addSubscription(new subscriptions.SmsSubscription(smsNumber.valueAsString()));