         | Did this page help you? Yes No Tell us about it... |
Welcome
This is the Amazon Simple Queue Service API Reference. This section describes who should read this guide, how the guide is organized, and other resources related to the Amazon Simple Queue Service (Amazon SQS).
Amazon SQS offers reliable and scalable hosted queues for storing messages as they travel between computers. By using Amazon SQS, you can move data between distributed components of your applications that perform different tasks without losing messages or requiring each component to be always available.
|
Location of the current WSDL. | |
|
Information about using the API. | |
|
List of the Amazon SQS actions by function. | |
|
Parameters that all Query actions can use | |
|
Client and server errors the API returns | |
|
Information about this product | |
|
Regions and endpoints for Amazon SQS |
API Versions
The version of an API is specified as a date, such as 2011-10-01. The following table displays the actions associated with each API version.
| Action | 2008-01-01 | 2009-02-01 | 2011-10-01 |
|---|---|---|---|
CreateQueue |
 |
|
|
ListQueues |
|
|
|
DeleteQueue |
|
|
|
GetQueueAttributes |
|
|
|
SetQueueAttributes |
|
|
|
SendMessage |
|
|
|
ReceiveMessage |
|
|
|
DeleteMessage |
|
|
|
AddPermission |
|
| |
RemovePermission |
|
| |
ChangeMessageVisibility |
|
| |
GetQueueUrl |
| ||
SendMessageBatch |
| ||
DeleteMessageBatch |
| ||
ChangeMessageVisibilityBatch |
|
The version of the API can be found in the URLs of the WSDL file. It can also be found in the target namespace of the WSDL file.
You can retrieve the WSDL for a previous version of the API by replacing the version date in the URL with the desired version. For example, the following retrieves the WSDL for API version 2008-01-01.
http://sqs.us-east-1.amazonaws.com/doc/2008-01-01/QueueService.wsdl
![[Important]](images/important.png) | Note to Users of the 2008-01-01 API Version |
|---|---|
With the release of version 2009-02-01 we changed how you reference a queue. In the 2008-01-01 API version you used the following structure: http://sqs.us-east-1.amazonaws.com/<queuename> In the 2009-02-01 and 2011-10-01 API versions, you must insert the queue owner's AWS account number before the queue name in all service requests other than CreateQueue and ListQueues: http://sqs.us-east-1.amazonaws.com/ |
Specifying the API Version
For all requests, you must specify the API version you want to use with the
Version parameter. Specifying the
version ensures that the service does not return response elements that your application is not
designed to handle.
The following example specifies the latest API version with the Version parameter.
http://sqs.us-east-1.amazonaws.com/
?Action=CreateQueue
&QueueName=queue2
&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE
&Version=2011-10-01
&Expires=2011-10-10T12:00:00Z
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQEXAMPLE
&SignatureVersion=2
&SignatureMethod=HmacSHA256
