Lessons

Practical Lesson on Subscribing to an SNS Topic

Introduction

In this practical lesson, we will learn how to subscribe to an SNS (Simple Notification Service) topic. SNS is a fully managed messaging service provided by AWS that makes it easy to set up, operate, and send notifications from the cloud. Subscribing to an SNS topic allows you to receive notifications when certain events occur in your AWS environment.

Prerequisites

Before we begin, make sure you have the following prerequisites:

  • An AWS account
  • AWS CLI installed and configured
  • Node.js and npm installed
  • Basic knowledge of AWS CDK and Typescript

Setting up the SNS Topic

First, let’s create an SNS topic using AWS CDK with Typescript. Create a new CDK project and install the necessary dependencies.

mkdir sns-topic-subscription
cd sns-topic-subscription
cdk init app --language typescript
npm install @aws-cdk/aws-sns @aws-cdk/aws-sns-subscriptions

Next, open the lib/sns-topic-subscription-stack.ts file and add the following code to create an SNS topic:

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

const topic = new sns.Topic(this, 'MyTopic');

new subs.EmailSubscription('your@email.com', topic);

This code creates an SNS topic named ‘MyTopic’ and subscribes an email address to receive notifications.

Subscribing to the SNS Topic

Now, let’s subscribe to the SNS topic using AWS CLI commands. First, list the available SNS topics in your AWS account:

aws sns list-topics

Copy the ARN (Amazon Resource Name) of the SNS topic you created earlier. Next, subscribe an email address to the SNS topic:

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

You will receive a confirmation email to confirm the subscription. Follow the instructions in the email to confirm the subscription.

Testing the Subscription

To test the subscription, publish a message to the SNS topic using the AWS CLI:

aws sns publish --topic-arn <your-topic-arn> --message "Hello, world!"

You should receive an email notification with the message “Hello, world!“.

Conclusion

In this practical lesson, we learned how to subscribe to an SNS topic using AWS CDK with Typescript and AWS CLI commands. We created an SNS topic, subscribed an email address to receive notifications, and tested the subscription by publishing a message to the topic. Key learnings from this lesson include:

  • Creating an SNS topic using AWS CDK with Typescript
  • Subscribing to an SNS topic using AWS CLI commands
  • Testing the subscription by publishing a message to the SNS topic

Now that you have successfully subscribed to an SNS topic, you can explore more advanced features of SNS and integrate it into your AWS applications for real-time notifications and event-driven architectures.

Share :