WSDL Location and API Version

The Amazon SQS API is published through a Web Services Description Language (WSDL). The version of the Amazon SQS API supported with this document is 2009-02-01.

The SQS WSDL is available by locale at the following endpoints:

Region	URL
US East (Northern Virginia) Region	http://sqs.us-east-1.amazonaws.com/doc/2009-02-01/QueueService.wsdl
US West (Northern California) Region	http://sqs.us-west-1.amazonaws.com/doc/2009-02-01/QueueService.wsdl
EU (Ireland) Region	http://sqs.eu-west-1.amazonaws.com/doc/2009-02-01/QueueService.wsdl
Asia Pacific (Singapore) Region	http://sqs.ap-southeast-1.amazonaws.com/doc/2009-02-01/QueueService.wsdl
Asia Pacific (Tokyo) Region	http://sqs.ap-northeast-1.amazonaws.com/doc/2009-02-01/QueueService.wsdl

	Note
	As of 2009 the SQS schema is incorporated into the WSDL. There is no longer a separate URL for the schema.

API Versions

The version of an API is specified as a date, such as 2009-02-01. When a new version of the API is released, previous versions are supported for a limited time to allow applications to continue to function until they are upgraded. If you're new to Amazon SQS, you must use version 2009-02-01. If you try to use a previous version, you'll receive the NotAuthorizedToUseVersion error.

	Important
The 2009-02-01 version is compatible with 2008-01-01 but not with any other previous API versions. Queues created with previous versions are not accessible with the 2008-01-01 or above version, and queues created with the 2008-01-01and above version are not accessible with previous versions. If you currently use a previous version, you must upgrade to at least the 2008-01-01 version if you want to continue using SQS. For information about what's different in the new version, go to the Amazon SQS Migration Guide for Version 2008-01-01.

Important

The 2009-02-01 version is compatible with 2008-01-01 but not with any other previous API versions. Queues created with previous versions are not accessible with the 2008-01-01 or above version, and queues created with the 2008-01-01and above version are not accessible with previous versions. If you currently use a previous version, you must upgrade to at least the 2008-01-01 version if you want to continue using SQS. For information about what's different in the new version, go to the Amazon SQS Migration Guide for Version 2008-01-01.

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 2007-05-01.

http://sqs.us-east-1.amazonaws.com/doc/2007-05-01/QueueService.wsdl

Specifying the API Version

For all requests, you must explicitly request the API version you want to use. Specifying the version ensures that the service does not return response elements that your application is not designed to handle.

In Query requests, you include the Version parameter.

http://sqs.us-east-1.amazonaws.com/
?Action=CreateQueue
&QueueName=queue2
&AWSAccessKeyId=0GS7573JW74RZM612K0AEXAMPLE
&Version=2009-02-01
&Expires=2008-02-10T12:00:00Z
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQEXAMPLE
&SignatureVersion=2
&SignatureMethod=HmacSHA256