What's New

Clarification

Clarified what the ListQueues action returns if you're using both the 2007-05-01 version of the WSDL and the 2008-01-01 version. For more information, see ListQueues.

29 February 2008

Update

Removed information about the StringToSignBytes element, because SQS no longer includes it in the error response when returning an AuthFailure error. We also added information about the Amazon SQS scratchpad, which you can use to help troubleshoot authentication issues with Query requests that use signature version 1. We also updated the Java code snippet that shows how to construct the string to sign for Query requests that use signature version 1. For more information, see Query Request Authentication.

29 February 2008

Error Correction

Previously, the documentation incorrectly indicated that when you specify a queue when using the REST API, you include the entire queue URL. Instead, you omit the http://queue.amazon.aws.com from the front of the URL and provide what's left. For more information, see About the Queue URL.

3 January 2008

Error Correction

Previously, the documentation incorrectly indicated that the error AWS.SimpleQueueService.QueueNameExists would be returned if you tried to create a new queue with the name of an existing queue. Instead, this does not result in an error, and SQS simply returns the queue URL for the existing queue. For the Query and SOAP APIs, see CreateQueue. For the REST API, see POST on QueueService.

3 January 2008

Enhancements

Added a feedback link on each HTML page so that readers can provide feedback about the documentation.

1 October 2007

Expansion of Material

Added information about a new error called AWS.SimpleQueueService.QueueDeletedRecently. For the Query and SOAP APIs, see the list of errors in CreateQueue. For the REST API, see the list of errors in POST on QueueService.

10 August 2007

Expansion of Material

Added information about a new error called InvalidAttributeName. See the list of errors in GetQueueAttributes and SetQueueAttributes.

10 August 2007

Clarification

Clarified the information about queue URLs. See About the Queue URL.

10 August 2007

Error Correction

Previously, the documentation incorrectly indicated that the error NonEmptyQueue would be returned if you tried to delete a non-empty queue (and didn't use the ForceDeletion parameter). The correct error is AWS.SimpleQueueService.NonEmptyQueue (HTTP Status 400). Also, the guide listed HTTP Status "4xx" for several of the errors. Those have been updated to the correct values (HTTP Status 400).

10 August 2007

New Feature

You can now retrieve an approximate number of messages in a queue. This is useful to determine the resources required to process the messages in the queue. For more information, see Resources Required to Process Messages. For Query and SOAP API information, see the GetQueueAttributes action. This feature is currently not supported for the REST API.

15 May 2007

New Feature

You can now delete a queue even if it's not empty by providing a new request parameter called ForceDeletion. For more information, see the DeleteQueue action for Query and SOAP, and see the DELETE on MessageQueue action for REST.

15 May 2007

New Feature

You can now change the visibility timeout for an individual message. For more information, see Visibility Timeout. For Query and SOAP API information, see the new ChangeMessageVisibility action. This feature is currently not supported for the REST API.

15 May 2007

New Feature

For the Query API, you can now send messages to a queue that are up to 256 KB in size. See SendMessage for details.

15 May 2007

New Feature

For the Query and SOAP APIs, SQS introduced the concept of attributes for queues. This guide now includes topics for these new Query and SOAP actions:

15 May 2007

Reorganization of Material

We have combined the API information for the Query API and the SOAP API because they are largely identical. See Query and SOAP API Reference.

15 May 2007

Expansion of Material

We have enhanced the introductory and conceptual information about Amazon SQS. See Introduction to Amazon SQS and How SQS Queues Work.

15 May 2007

Expansion of Material

We have enhanced and clarified the information about access control. See Access Control for Queues.

15 May 2007

Expansion of Material

We have added information about creating requests for each of the APIs. See About Requests and Responses.

15 May 2007

Reorganization of Material

We have restructured and enhanced the information about authentication. See Request Authentication.

15 May 2007

Expansion of Material

We have enhanced the information about errors. See Common Errors.

15 May 2007

Expansion of Material

We have added a glossary. See Glossary.

15 May 2007