Menu
Amazon Simple Queue Service
Developer Guide

Document History

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

  • API version: 2012-11-05

  • Latest documentation update: September 29, 2017

Change Desription Date Changed
Update Added a note about the Amazon SQS Buffered Asynchronous Client to the Increasing Throughput with Horizontal Scaling and Batching section. September 29, 2017
Update Corrected the diagrams in the Using Amazon SQS and IAM Policies section. September 19, 2017
New feature

The complete set of Amazon SQS actions is displayed in the Actions list on the Add a Permission to MyQueue dialog box. For more information, see the Adding Permissions to an Amazon SQS Queue tutorial.

September 1, 2017
Update Clarified the information in the Changing a Message's Visibility Timeout section. August 29, 2017
Update Clarified the permissions for the SendMessage and SendMessageBatch API actions in Actions and Resource Reference. August 17, 2017
Update Updated information about dead-letter queues in the General Recommendations section. August 15, 2017
Update
August 9, 2017
Update

Changed the deprecated AmazonSQSClient method to AmazonSQSClientBuilder and revised the corresponding region specification in the Getting Started with Standard Queues section.

July 27, 2017
Update

Clarified the throughput for standard and FIFO queues throughout this guide:

  • Standard queues can support a nearly unlimited number of transactions per second (TPS) per API action.

  • Without batching, FIFO queues can support up to 300 messages per second (300 send, receive, or delete operations per second).

  • If you take advantage of the maximum batching of 10 messages per operation, FIFO queues can support up to 3,000 messages per second.

July 25, 2017
Update Clarified the compatibility between Amazon SQS SSE queues and AWS and third-party service features throughout this guide:

Some features of AWS services that can send notifications to Amazon SQS using the AWS Security Token Service AssumeRole API action are compatible with SSE but work only with standard queues:

Other features of AWS services or third-party services that send notifications to Amazon SQS aren't compatible with SSE, despite allowing you to set an encrypted queue as a target:

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

July 20, 2017
Update

Corrected the information in the Limits Related to Messages section.

June 23, 2017
Update

Clarified the information in the Using Amazon SQS Dead-Letter Queues section.

June 20, 2017
New feature FIFO (First-In-First-Out) queues are available in the US East (N. Virginia) region, in addition to the EU (Ireland), US East (Ohio), and US West (Oregon) regions. For more information about how FIFO queues work and how to get started using them, see FIFO (First-In-First-Out) Queues. June 14, 2017
New feature FIFO (First-In-First-Out) queues are available in the EU (Ireland) region, in addition to the US East (Ohio) and US West (Oregon) regions. For more information about how FIFO queues work and how to get started using them, see FIFO (First-In-First-Out) Queues. June 8, 2017
Update
June 2, 2017
Update

Updated the What is Amazon Simple Queue Service? section.

June 1, 2017
Update
May 24, 2017
New feature Server-side encryption (SSE) for Amazon SQS is available in the US East (N. Virginia) region, in addition to the US East (Ohio) and US West (Oregon) regions. For more information on server-side encryption and how to get started using it, see Protecting Data Using Server-Side Encryption (SSE) and AWS KMS . May 23, 2017
New feature
  • You can use the Amazon SQS Extended Client Library for Java together with the Amazon SQS Java Message Service (JMS) Client.

  • The Amazon SQS Java Messaging Library has been updated to 1.0.3. For more information, see Using JMS with Amazon SQS.

  • Updated the Using JMS with Amazon SQS section.

May 19, 2017
New feature AWS has expanded its HIPAA compliance program to include Amazon SQS as a HIPAA Eligible Service. Added the Amazon SQS Compliance section. May 1, 2017
New feature Server-side encryption (SSE) for Amazon SQS is available in the US East (Ohio) and US West (Oregon) regions. SSE lets you protect the contents of messages in Amazon SQS queues using keys managed in the AWS Key Management Service (AWS KMS). For more information on server-side encryption and how to get started using it, see Protecting Data Using Server-Side Encryption (SSE) and AWS KMS . For tutorials, see the following:

SSE adds the KmsMasterKeyId and KmsDataKeyReusePeriodSeconds attributes to the CreateQueue, GetQueueAttributes, and SetQueueAttributes actions.

Important

Some features of AWS services that can send notifications to Amazon SQS using the AWS Security Token Service AssumeRole API action are compatible with SSE but work only with standard queues:

Other features of AWS services or third-party services that send notifications to Amazon SQS aren't compatible with SSE, despite allowing you to set an encrypted queue as a target:

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

April 28, 2017
Update Restructured and updated the Amazon SQS Long Polling section. April 25, 2017
New feature
  • The Amazon SQS Extended Client Library for Java and Amazon SQS Java Message Service (JMS) Client support FIFO queues.

  • The Amazon SQS Java Messaging Library has been updated to 1.0.2.

  • Updated the Using JMS with Amazon SQS section.

April 24, 2017
New feature AWS CloudFormation lets your create FIFO queues. Added the Create a Queue Using AWS CloudFormation tutorial. March 28, 2017
Update Updated the Authentication and Access Control section with new content. February 6, 2017
Update Retired the Amazon Simple Queue Service Getting Started Guide and incorporated some of its content into the following sections of this guide: December 16, 2016
Update Restructured and updated the Authentication and Access Control section. December 2, 2016
New feature FIFO (First-In-First-Out) queues or standard queues (the new name for existing queues) are available in the US West (Oregon) and US East (Ohio) regions. For more information about how FIFO queues work and how to get started using them, see the following:

For revised Amazon SQS tutorials, see the following:

FIFO queues add the following API functionality:

Important

As of November 17, 2016, Amazon SQS no longer publishes a WSDL.

The Amazon SQS Buffered Asynchronous Client doesn't currently support FIFO queues.

Some AWS or external services that send notifications to Amazon SQS might not be compatible with FIFO queues, despite allowing you to set a FIFO queue as a target.

The following features of AWS services aren't currently compatible with FIFO queues:

For information about compatibility of other services with FIFO queues, see your service documentation.

FIFO queues don't support timers on individual messages.

November 17, 2016
Update Renamed the Walkthroughs section to Amazon SQS Tutorials. November 2, 2016
New feature The ApproximateAgeOfOldestMessage CloudWatch metric lets you find the approximate age of the oldest non-deleted message in the queue. For more information, see Available CloudWatch Metrics for Amazon SQS. August 31, 2016
Update Added the Best Practices for Amazon SQS section. May 27, 2016
Update Added the Amazon SQS Limits section. May 12, 2016
New feature You can view CloudWatch metrics from within the Amazon SQS console for up to 10 of your queues at a time. For more information, see Monitoring Amazon SQS using CloudWatch. February 12, 2016

Update

Updated Amazon SQS console screenshots.

December 7, 2015
New feature The Amazon SQS Extended Client Library for Java lets you manage Amazon SQS messages with Amazon S3. For more information, see Managing Large Amazon SQS Messages Using Amazon S3 in the Amazon Simple Queue Service Developer Guide. October 27, 2015

New feature

Amazon SQS lets you use JMS (Java Message Service) with Amazon SQS queues. For more information, see Using JMS with Amazon SQS in the Amazon Simple Queue Service Developer Guide.

December 29, 2014

New feature

Amazon SQS lets you delete the messages in a queue by using the PurgeQueue API. For more information, see PurgeQueue in the Amazon SQS API Reference.

December 8, 2014

Update

Updated information about access keys. For more information, see Your Access Keys.

August 4, 2014

New feature

Amazon SQS lets you log API calls by using AWS CloudTrail. For more information, see Logging Amazon SQS API Actions Using AWS CloudTrail.

July 16, 2014

New feature

Amazon SQS provides support for message attributes. For more information, see Using Amazon SQS Message Attributes.

May 6, 2014

New feature

Amazon SQS provides support for dead-letter queues. For more information, see Using Amazon SQS Dead-Letter Queues.

January 29, 2014

New feature

You can subscribe an Amazon SQS queue to an Amazon SNS topic using the AWS Management Console for Amazon SQS, which simplifies the process. For more information, see Subscribing an Amazon SQS Queue to an Amazon SNS Topic.

November 21, 2012

New feature

The 2012-11-05 API version of Amazon SQS adds support for Signature Version 4, which provides improved security and performance. For more information about Signature Version 4, see Query Request Authentication.

November 5, 2012

New feature

The AWS SDK for Java includes a buffered asynchronous client, AmazonSQSBufferedAsyncClient, for accessing Amazon SQS. This client allows for easier request batching by enabling client-side buffering, where calls made from the client are first buffered and then sent as a batch request to Amazon SQS. For more information about client-side buffering and request batching, see Client-Side Buffering and Request Batching.

November 5, 2012

New feature

The 2012-11-05 API version of Amazon SQS adds long polling support. Long polling allows Amazon SQS to wait for a specified amount time for a message to be available instead of returning an empty response if one isn't available. For more information about long polling, see Amazon SQS Long Polling.

November 5, 2012