Create an SNS Topic

The Dash Replenishment Service (DRS) uses SNS Topics to notify you (the device maker) of changes to device status, order state, subscription status, and more.

Amazon's Simple Notification Service (SNS) is a pub-sub service from AWS that makes it easy to set up, manage, and send messages instantly to applications or users. See Notification Messages for a complete list of supported DRS notifications.

Create an SNS Topic for DRS

  1. Log in to the AWS Management Console.
  2. Select Simple Notification Service from Application Integration
  3. From the SNS Dashboard, click Create topic.
  4. Enter a Topic name and Display name, then click Create topic.
    • Topic Name - Used to create a permanent unique identifier called an Amazon Resource Name (ARN), which will be used to configure your SNS Notifications.

Allow DRS to Publish Messages to Your Topic

  1. Copy the ARN you just created. You will use this to link DRS-enabled devices to your new topic in step 6.

  2. Click the ARN for the topic you've created.
  3. Click Other topic actions and then click Edit topic policy.
  4. From Basic View, under Allow these users to publish messages to this topic, select Only these AWS user and enter your AWS Account ID and the DRS AWS Account ID.
    • To access your AWS Account ID, go to the AWS Console.
    • Enter the following for the DRS AWS Account ID: 476877469412
  5. Click Update policy.
  6. Go to your DRS Self-Service portal and paste the ARN you copied in step 1 in the "Notification" field under "App Settings".

Process incoming notifications

You have completed the tutorial!

If you wish to perform any task upon receiving an SNS notification, the next section provides an overview of the messages you will receive.

You may choose to trigger a Lambda function to update a database or create custom routines in your cloud.