WSDL and Schema Location

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

The SQS WSDL is located at:

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

The SQS schema is located at:

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

Service API Versions

When a new version of the service API is released, previous versions are supported for a limited time to allow applications to continue to function until they are upgraded. The version of a service API is specified as a date, such as 2007-05-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, to retrieve the WSDL for API version 2006-04-01:

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

For information about which versions of the API are supported, visit the Amazon SQS page of the Amazon Web Services web site at http://aws.amazon.com/sqs.

Accessing a Specific Service Version

For all requests, you must explicitly request the 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=2007-05-01
&Expires=2007-05-12T12:00:00Z
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQE=

In REST requests, you include the AWS-Version header:

POST /?QueueName=queue2 HTTP/1.1
Host: queue.amazonaws.com
Authorization: [AWS authentication string]
Content-Type: text/plain
AWS-Version: 2007-05-01
Date: Mon, 23 Apr 2007 21:12:00 GMT

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:Body>
    <CreateQueue xmlns="http://queue.amazonaws.com/doc/2007-05-01">
      <AWSAccessKeyId>0PAP1H1P8JJVZEXAMPLE</AWSAccessKeyId>
      <Timestamp>2007-05-02T00:00:00.000Z</Timestamp>
      <Signature>SZf1CHmQ/nrZbsrC13hCZS061yws</Signature>
      <QueueName>MyQueue</QueueName>
    </CreateQueue>
  </soapenv:Body>
</soapenv:Envelope>