Getting started with Amazon SNS

This section helps you become more familiar with Amazon SNS by showing you how to manage topics, subscriptions, and messages using the Amazon SNS console.

Prerequisites

Before you begin, complete the steps in Setting up access for Amazon SNS.

Step 1: Create a topic

1. Sign in to the Amazon SNS console.

2. In the left navigation pane, choose Topics.

3. On the Topics page, choose Create topic.

4. By default, the console creates a FIFO topic. Choose Standard.

5. In the Details section, enter a Name for the topic, such as MyTopic.

6. Scroll to the end of the form and choose Create topic.

   The console opens the new topic's Details page.

Step 2: Create a subscription to the topic

1. In the left navigation pane, choose Subscriptions.

2. On the Subscriptions page, choose Create subscription.

3. On the Create subscription page, choose the Topic ARN field to see a list of the topics in your AWS account.

4. Choose the topic that you created in the previous step.

5. For Protocol, choose Email.

6. For Endpoint, enter an email address that can receive notifications.

7. Choose Create subscription.

   The console opens the new subscription's Details page.

8. Check your email inbox and choose Confirm subscription in the email from AWS Notifications. The sender ID is usually "[e-mail]".

9. Amazon SNS opens your web browser and displays a subscription confirmation with your subscription ID.

Step 3: Publish a message to the topic

1. In the left navigation pane, choose Topics.

2. On the Topics page, choose the topic that you created earlier, and then choose Publish message.

   The console opens the Publish message to topic page.

3. (Optional) In the Message details section, enter a Subject, such as:

   Hello from Amazon SNS!

4. In the Message body section, choose Identical payload for all delivery protocols, and then enter a message body, such as:

   Publishing a message to an SNS topic.

5. Choose Publish message.

   The message is published to the topic, and the console opens the topic's Details page.

6. Check your email inbox and verify that you received an email from Amazon SNS with the published message.

Step 4: Delete the subscription and topic

1. On the navigation panel, choose Subscriptions.

2. On the Subscriptions page, choose a confirmed subscription and then choose Delete.

   Note

   You can't delete a pending confirmation. After 48 hours, Amazon SNS deletes it automatically.

3. In the Delete subscription dialog box, choose Delete.

   The subscription is deleted.

4. On the navigation panel, choose Topics.

5. On the Topics page, choose a topic and then choose Delete.

   Important

   When you delete a topic, you also delete all subscriptions to the topic.

6. On the Delete topic MyTopic dialog box, enter delete me and then choose Delete.

   The topic is deleted.

Next steps

Now that you've created a topic with a subscription and sent messages to the topic, you might want to try the following:

• Explore the AWS Developer Center.

• Learn about protecting your data in the Security section.

• Enable server-side encryption for a topic.

• Enable server-side encryption for a topic with an encrypted Amazon Simple Queue Service (Amazon SQS) queue subscribed.

• Subscribe AWS Event Fork Pipelines to a topic.