Set Up Amazon SNS

To create an Amazon SNS topic

1. Open the Amazon SNS console at https://console.aws.amazon.com/sns/.

2. If necessary, change the region. From the navigation bar, select the region that meets your needs. For more information, see Regions and Endpoints.

   

3. In Getting Started, click Create New Topic.

   The Create New Topic dialog box opens.

   

4. Enter the topic name MyTopic in the Topic Name field.

5. Click Create Topic.

   The new topic appears in the Topic Details page.

   

6. Copy the Topic ARN for the next task.

To subscribe to an Amazon SNS topic

1. Open the Amazon SNS console at https://console.aws.amazon.com/sns/.

2. If necessary, change the region. From the navigation bar, select the region that meets your needs. For more information, see Regions and Endpoints.

   

3. In the navigation pane, click My Subscriptions in the navigation pane.

   The My Subscriptions page opens.

4. Click Create New Subscription.

   The Subscribe dialog box opens.

   

5. In the Topic ARN field, paste the topic ARN you created in the previous task, for example: arn:aws:sns:us-east-1:054794666394:MyTopic.

6. Select Email in the Protocol drop-down list.

7. Enter an email address you can use to receive the notification in the Endpoint field, and then click Subscribe.

   Important

   Entourage Users: Entourage strips out the confirmation URL. Please enter an email address you can access in a different email application.

8. Go to your email application and open the message from AWS Notifications, and then click the link to confirm your subscription.

   Your web browser displays a confirmation response from Amazon SNS.

To publish to an Amazon SNS topic

1. Open the Amazon SNS console at https://console.aws.amazon.com/sns/.

2. If necessary, change the region. From the navigation bar, select the region that meets your needs. For more information, see Regions and Endpoints.

   

3. In the navigation pane, under My Topics, click the topic you want to publish.

   The Topic Details page opens.

4. Click Publish to Topic.

   The Publish dialog box opens.

   

5. Enter a subject line for your message in the Subject field, and a brief message in the Message field.

6. Click Publish Message.

   A confirmation dialog box opens.

7. Click Close.

8. Check your email to confirm that you received the message from the topic.

To set up an Amazon SNS topic

1. Create the topic with the Amazon SNS CLI command sns-create-topic. You receive a topic resource name as a return value:

   Prompt>sns-create-topic  --name  MyTopic

   Amazon SNS returns the following Topic ARN:

   arn:aws:sns:us-east-1:887848922426:MyTopic

2. Subscribe your email address to the topic with the Amazon SNS CLI command sns-subscribe. You will receive a confirmation email message if the subscription request succeeds.

   Prompt>sns-subscribe  --topic arn:aws:sns:us-east-1:887848922426:MyTopic  --protocol SMTP  --endpoint <your-email-address>

   Amazon SNS returns the following:

   Subscription request received

3. Confirm that you intend to receive email from Amazon SNS by clicking the confirmation link in the body of the message to complete the subscription process.

4. Check the subscription with the Amazon SNS CLI command sns-list-subscription-by-topic.

   Prompt>sns-list-subscription-by-topic  --topic arn:aws:sns:us-east-1:887848922426:MyTopic

   Amazon SNS returns the following:

   arn:aws:sns:us-east-1:887848922426:MyTopic:97fbacb0-7706-4ee9-9f8c-d56074b25278  
     SMTP me@my_company.com

5. Publish a message directly to the topic with the sns-publish command to ensure that the topic is properly configured.

   Prompt>sns-publish  --message  "Verification"  --topic arn:aws:sns:us-east-1:887848922426:MyTopic

   Amazon SNS returns the following:

   b94635b4-9cc6-4895-b961-87e9a1ff8ff8

6. Check your email to confirm that you received the message from the topic.