CDK Subscription Constructs for AWS SNS
Project description
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.
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_sns as sns
my_topic = sns.Topic(self, "MyTopic")
HTTPS
Add an HTTP or HTTPS Subscription to your topic:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_sns_subscriptions as subscriptions
my_topic.add_subscription(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.
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
url = CfnParameter(self, "url-param")
my_topic.add_subscription(subscriptions.UrlSubscription(url.value_as_string()))
Amazon SQS
Subscribe a queue to your topic:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_sqs as sqs
import aws_cdk.aws_sns_subscriptions as subscriptions
my_queue = sqs.Queue(self, "MyQueue")
my_topic.add_subscription(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:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_lambda as lambda_
import aws_cdk.aws_sns_subscriptions as subscriptions
my_function = lambda_.Function(self, "Echo",
handler="index.handler",
runtime=lambda_.Runtime.NODEJS_10_X,
code=lambda_.Code.from_inline(f"exports.handler = {handler.toString()}")
)
my_topic.add_subscription(subscriptions.LambdaSubscription(my_function))
Subscribe an email address to your topic:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_sns_subscriptions as subscriptions
my_topic.add_subscription(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.
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
email_address = CfnParameter(self, "email-param")
my_topic.add_subscription(subscriptions.EmailSubscription(email_address.value_as_string()))
Note that email subscriptions require confirmation by visiting the link sent to the email address.
SMS
Subscribe an sms number to your topic:
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
import aws_cdk.aws_sns_subscriptions as subscriptions
my_topic.add_subscription(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.
# Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
sms_number = CfnParameter(self, "sms-param")
my_topic.add_subscription(subscriptions.SmsSubscription(sms_number.value_as_string()))
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aws-cdk.aws-sns-subscriptions-1.87.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ede31771108094df25abe6e232488e301a1c371aa2757cc7fd1d06c374c84f33 |
|
MD5 | 55123d7b94b25105ac45b90e6c1c80a5 |
|
BLAKE2b-256 | 2cb65bcddb5a358b0b9f7a86c0b4e15e7f2dfb2bd81f0eb506925e4138c7f310 |
Hashes for aws_cdk.aws_sns_subscriptions-1.87.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6761737640078047602333bc5e16740fec2c28cf81ec6c3a5dd7ecde122b9ada |
|
MD5 | 552d8bf7ac0c8f809e4190541560e7fc |
|
BLAKE2b-256 | 7a0e81b0e28e056b8d4a5e815d6220a6473dfa7563315d61bce80c59f3c20914 |