WSDL and Schema Location

The Simple Queue Service (SQS) API is published through a Web Services Description Language (WSDL) and an XML Schema document. The locations of the WSDL and Schema for the Simple Queue Service are listed below.

The latest version of the Simple Queue Service API is 2006-04-01.

The SQS WSDL contains 2 port types: QueueService and MessageQueue, each of which represents and endpoint on which actions can be performed.

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

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

The version of the service is defined in the service WSDL, and is simply the date that is embedded within the namespace. In this case, the version is 2006-04-01. Service versioning ensures that applications that validate against the current or older schemas are not affected when an AWS service adds new elements to the schema. The service version is also required in all access control action requests.

The service version is defined in the namespace of the Web Services Description Language (WSDL) document. The WSDL namespace appears in the first line or element of the WSDL file. The following is the first element from an Simple Queue Service WSDL:

            <xs:import namespace="http://queue.amazonaws.com/doc/2006-04-01/"

The service version also appears in the URL to the WSDL file. Specifically, the URL for the WSDL for this version of SQS is:

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

The XML schema responses for requests is also versioned. Just as you can access specific WSDL versions by including the version number (or date) in the WSDL URL, you can also access schemas by inserting the version number in the schema URL. For this version of SQS, the URL to access the schema associated with the QueueService.wsdl is:

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

For all requests, you must explicitly request the version you want to use. Specifying the version parameter ensures that the service does not return response elements that your application is not designed to handle. In REST and Query requests, this is done by including the Version parameter in your request. For SOAP, this is accomplished by the namespace of the first child element of the Body> element.

Note:

When accessing the WSDL or Schema by opening the URL in a Web browser, you must view the source of the loading page to view the actual .wsdl or .xsd rather than the browser's interpretation of them.