Amazon Simple Notification Service
Developer Guide (API Version 2010-03-31)

Document History

The following table describes the important changes to the documentation since the last release of the Amazon SNS Developer Guide.

Change Description Date Changed
New Feature Server-side encryption (SSE) for Amazon SNS lets you protect the contents of messages in Amazon SNS topics using keys managed in the AWS Key Management Service (AWS KMS). For more information about server-side encryption and how to get started using it, see Protecting Amazon SNS Data Using Server-Side Encryption (SSE) and AWS KMS and Enabling Server-Side Encryption (SSE) for an Amazon SNS Topic.

SSE adds the ability to set the KmsMasterKeyId attribute using the CreateTopic and SetTopicAttributes API actions.

Important

All requests to topics with SSE enabled must use HTTPS and Signature Version 4.

For information about compatibility of other services with encrypted topics, see your service documentation.

November 15, 2018
Guide Changes October 25, 2018
Guide Changes Corrected the example headers and requests in the Amazon SNS Message and JSON Formats section. October 8, 2018
Guide Changes October 5, 2018
Guide Changes Added the following statement to the Getting Started with Google Cloud Messaging for Android section: On April 10, 2018, Google announced the deprecation of its Google Cloud Messaging (GCM) platform. Specifically, the GCM server and client APIs are deprecated and will be removed on April 11, 2019. For more information, see The End of Google Cloud Messaging, and What it Means for Your Apps. September 24, 2018
Guide Changes Made minor corrections throughout this guide. September 20, 2018
Guide Changes Updated all the links in the Platform Response Codes section. September 19, 2018
Guide Changes
September 17, 2018
Guide Changes
September 13, 2018
Guide Changes September 12, 2018
Guide Changes Corrected the information in the following sections:

September 6, 2018

Guide Changes
September 5, 2018
Guide Changes
September 4, 2018
Guide Changes August 30, 2018
Guide Changes Reconfigured and restructured parts of this guide. August 22, 2018
AWS SDK for .NET examples Code examples are provided on multiple pages that show you how to use Amazon SNS with the AWS SDK for .NET. For more information, see Using the AWS SDK for .NET with Amazon SNS. August 7, 2018
Tutorial for publishing from a VPC Follow a tutorial to learn how to set up a VPC and publish private messages to Amazon SNS. See Tutorial: Publishing Amazon SNS Messages Privately from Amazon VPC. June 8, 2018
CloudWatch metrics for filtered messages Amazon SNS now sends metrics to Amazon CloudWatch about messages that are filtered by subscription filter policies. For more information, see Amazon SNS Metrics. May 30, 2018
Publishing from a VPC Publish to your Amazon SNS topics privately from Amazon Virtual Private Cloud. See Publishing to an Amazon SNS Topic from Amazon Virtual Private Cloud. April 10, 2018
Removing filter policies Remove the filter policy that is assigned to a subscription to stop filtering messages. See Removing Subscription Filter Policies. April 10, 2018
New operations for subscription filter policies In addition to exact matching with string values, filter policies support the following operations for matching message attributes: anything-but matching, prefix matching, exact numeric matching, and numeric range matching. For more information, see Amazon SNS Message Filtering. March 12, 2018
Subscription filter policies Subscribers can selectively receive messages published to Amazon SNS topics by applying filter policies to topic subscriptions. For more information, see Amazon SNS Message Filtering. November 21, 2017
Applying message attributes Applying Message Attributes includes steps and examples for applying message attributes by using the Amazon SNS console, AWS CLI, and the AWS SDK for Java. November 21, 2017
CloudWatch metric for SMS spend Amazon SNS sends the SMSMonthToDateSpentUSD metric to CloudWatch. This metric shows the charges you have accrued since the start of the current calendar month for sending SMS messages. For more information, see Amazon SNS Metrics. March 31, 2017
Dedicated short codes for SMS To send SMS messages using a persistent short code, you can reserve a dedicated short code that is assigned to your account and available exclusively to you. For more information, see Reserving a Dedicated Short Code for SMS Messaging. March 06, 2017
Amazon SNS supports worldwide SMS Amazon SNS now supports SMS messaging to more than 200 countries and regions. You can send a message directly to a phone number, or you can send a message to multiple phone numbers at once by subscribing those phone numbers to a topic and sending your message to the topic. For more information, see Using Amazon SNS for User Notifications with a Mobile Phone Number as a Subscriber (Send SMS). June 28, 2016

Platform endpoints and device tokens

Added a topic about how to create a platform endpoint and manage device tokens for Amazon SNS mobile push notification. For more information, see Create a Platform Endpoint and Manage Device Tokens.

September 23, 2015

Application event notifications

Added a topic about how to trigger notifications when certain application events occur. For more information, see Application Event Notifications.

September 23, 2015

New support for VoIP and Mac OS X push notifications

Added new topics about sending push notification messages to VoIP and Mac OS X apps using Apple Push Notification Service. For more information, see Getting Started with Apple Push Notification Service.

June 15, 2015

Invoking AWS Lambda functions

Added a topic on how to invoke Lambda functions using Amazon SNS notifications. For more information, see With a Lambda Function as a Subscriber.

April 09, 2015

Using Amazon SNS topic attributes for message delivery status

Added a topic on using Amazon SNS topic attributes for message delivery status. For more information, see Amazon SNS Topic Attributes for Message Delivery Status.

April 09, 2015

Support to log the delivery status of push notification messages

Added a topic on using Amazon SNS application attributes for message delivery status. For more information, see Using Amazon SNS Application Attributes for Message Delivery Status.

February 05, 2015

Support for AWS CloudTrail with Amazon Simple Notification Service

Added a topic on logging Amazon SNS API calls by using CloudTrail. For more information, see Logging Amazon Simple Notification Service API Calls Using AWS CloudTrail.

October 09, 2014

Amazon SNS mobile push high-level steps

Added a topic about the high-level steps you must perform to use Amazon SNS mobile push. This information should help you gain a better understanding of the steps involved when using the Amazon SNS mobile push APIs. For more information, see Amazon SNS Mobile Push High‐Level Steps.

October 09, 2014

Support for authenticated messages with Microsoft Push Notification Service for Windows Phone

Updated a topic on how to send authenticated messages with MPNS. For more information, see Getting Started with MPNS.

August 19, 2014

Support for setting a Time To Live (TTL) message attribute for mobile push notification messages

Added a topic on how to specify expiration metadata for a mobile push notification message. For more information, see Using the Amazon SNS Time To Live (TTL) Message Attribute for Mobile Push Notifications.

July 10, 2014

Support for Baidu Cloud Push, Microsoft Push Notification Service for Windows Phone, and Windows Push Notification Services

Added topics on how to use Baidu, MPNS, and WNS, with Amazon SNS to send push notification messages to mobile devices. For more information, see Getting Started with Baidu Cloud Push, Getting Started with MPNS, and Getting Started with WNS.

June 12, 2014

Message attributes

Message attributes allow you to provide structured metadata items about a message. For more information, see Amazon SNS Message Attributes.

June 12, 2014

Amazon SNS samples in Java

Added a section about using the AWS SDK for Java with Amazon SNS. Examples in this section show how to create a new Amazon SNS client, set the Amazon SNS endpoint to use, and create a new topic. In addition, examples are provided on how to subscribe to, publish to, and delete a topic. For more information, see Using the AWS SDK for Java with Amazon SNS.

April 23, 2014

Mobile push notifications

Added a topic about how to create and send custom platform-specific payloads in messages to mobile devices. For more information, see Send Custom Platform-Specific Payloads in Messages to Mobile Devices.

December 17, 2013

Mobile push notifications

Added support to send notification messages directly to apps on mobile devices. For more information, see Using Amazon SNS for User Notifications with a Mobile Application as a Subscriber (Mobile Push).

August 13, 2013

Initial Release

This is the first release of the Amazon SNS Developer Guide.

May 1, 2013