WSDL Location and API Version

The Amazon SQS API is published through a Web Services Description Language (WSDL) and an XML schema document. The version of the Amazon SQS API supported with this document is 2008-01-01.

The SQS WSDL is located at:

http://queue.amazonaws.com/doc/2008-01-01/QueueService.wsdl

The SQS schema is located at:

http://queue.amazonaws.com/doc/2008-01-01/QueueService.xsd

API Versions

The version of an API is specified as a date, such as 2008-01-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 2008-01-01. If you try to use a previous version, you'll receive the NotAuthorizedToUseVersion error.

	Important
The 2008-01-01 version is not compatible with previous API versions. Queues created with previous versions are not accessible with the 2008-01-01 version, and queues created with the 2008-01-01 version are not accessible with previous versions. If you currently use a previous version, you must upgrade to 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 2008-01-01 version is not compatible with previous API versions. Queues created with previous versions are not accessible with the 2008-01-01 version, and queues created with the 2008-01-01 version are not accessible with previous versions. If you currently use a previous version, you must upgrade to 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 and schema files. It can also be found in the target namespace of the WSDL and schema files.

You can retrieve the WSDL or schema files 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://queue.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://queue.amazonaws.com/
?Action=CreateQueue
&QueueName=queue2
&AWSAccessKeyId=0GS7573JW74RZM612K0AEXAMPLE
&Version=2008-01-01
&Expires=2008-02-10T12:00:00Z
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQEXAMPLE
&SignatureVersion=2
&SignatureMethod=HmacSHA256

In SOAP requests, the namespace of the first child element of the <Body> element specifies the version.

<?xml version="1.0" encoding="UTF-8" ?>
<soapenv:Envelope
     xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
     xmlns:xsd="http://www.w3.org/2001/XMLSchema"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header
     xmlns:aws="http://security.amazonaws.com/doc/2007-01-01/">
      <aws:AWSAccessKeyId>0PAP1H1P8JJVZEXAMPLE</AWSAccessKeyId>
      <aws:Timestamp>2008-02-10T00:00:00Z</Timestamp>
      <aws:Signature>SZf1CHmQ/nrZbsrC13hCZS061ywsEXAMPLE</Signature>
  </soapenv:Header>
  <soapenv:Body>
    <CreateQueue xmlns="http://queue.amazonaws.com/doc/2008-01-01">
      <QueueName>MyQueue</QueueName>
    </CreateQueue>
  </soapenv:Body>
</soapenv:Envelope>