Lessons

Practical Lesson on Managing Subscriptions in AWS SNS

Introduction

In this practical lesson, we will explore how to manage subscriptions in AWS SNS (Simple Notification Service). We will cover the basics of setting up subscriptions, managing them, and using AWS CDK with Typescript or AWS CLI commands to interact with SNS.

What is AWS SNS?

AWS SNS is a fully managed messaging service that allows you to send notifications to a variety of endpoints, such as email, SMS, HTTP, and more. Subscriptions in SNS allow you to define where these notifications should be sent.

Setting Up Subscriptions

To get started with managing subscriptions in AWS SNS, you first need to set up a topic. A topic is a communication channel that allows you to send messages to multiple subscribers. Let’s create a new SNS topic using AWS CDK with Typescript.

Creating an SNS Topic with AWS CDK

import * as sns from '@aws-cdk/aws-sns';
import * as cdk from '@aws-cdk/core';

const app = new cdk.App();
const stack = new cdk.Stack(app, 'SnsSubscriptionStack');

const topic = new sns.Topic(stack, 'MyTopic', {
  displayName: 'My SNS Topic',
});

new cdk.CfnOutput(stack, 'TopicArn', {
  value: topic.topicArn,
});

app.synth();

This code snippet creates a new SNS topic named ‘MyTopic’ with a display name of ‘My SNS Topic’. The topic’s ARN (Amazon Resource Name) is then outputted.

Managing Subscriptions

Once you have set up an SNS topic, you can start managing subscriptions to that topic. Subscriptions define where the messages published to the topic should be sent. Let’s add a subscription to our previously created SNS topic using AWS CDK with Typescript.

Adding a Subscription to an SNS Topic with AWS CDK

import * as snsSubscriptions from '@aws-cdk/aws-sns-subscriptions';
import * as sqs from '@aws-cdk/aws-sqs';

const queue = new sqs.Queue(stack, 'MyQueue');

topic.addSubscription(new snsSubscriptions.SqsSubscription(queue));

In this code snippet, we create an SQS (Simple Queue Service) queue named ‘MyQueue’ and add an SQS subscription to our SNS topic. This subscription will send messages published to the topic to the SQS queue.

Using AWS CLI Commands

In addition to using AWS CDK with Typescript, you can also manage subscriptions in AWS SNS using AWS CLI commands. Let’s subscribe an email address to our SNS topic using the AWS CLI.

Subscribing an Email Address to an SNS Topic with AWS CLI

aws sns subscribe --topic-arn <topic-arn> --protocol email --notification-endpoint example@example.com

Replace <topic-arn> with the ARN of your SNS topic and example@example.com with the email address you want to subscribe. This command subscribes the specified email address to the SNS topic using the email protocol.

Conclusion

In this practical lesson, we learned how to manage subscriptions in AWS SNS. We covered setting up an SNS topic, adding subscriptions to the topic, and using AWS CDK with Typescript and AWS CLI commands to interact with SNS. Key learnings from this lesson include:

  • Creating an SNS topic using AWS CDK with Typescript
  • Adding subscriptions to an SNS topic with AWS CDK
  • Subscribing endpoints to an SNS topic using AWS CLI commands

By following these steps, you can effectively manage subscriptions in AWS SNS and ensure that notifications are delivered to the appropriate endpoints.

Share :