Queries message queues under an Alibaba Cloud account. A response may contain multiple pages. A response contains only the QueueURL parameter. You can call the GetQueueAttributes operation to query the information of a queue based on the QueueURL parameter. To query message queues that have the same prefix, you must set the x-mqs-prefix parameter.

Request

A request consists of the following parts:

  • Request line

    GET / HTTP/1.1

  • Operation-specific request headers
    Parameter Description Required
    x-mqs-marker The start position of the next page to return. Set this parameter to the value of NextMarker parameter in the previous response. Optional
    x-mqs-ret-number The maximum number of entries to return for the current request. Valid values: 1 to 1000. Data type: integer. Default value: 1000. Optional
    x-mqs-prefix The prefix of queues. If you specify this parameter, only the queues that start with the prefix are returned. Optional

    For information about other request headers, see Common parameters.

  • Request Body

    None.

Response

A response consists of a status line, HTTP headers, and a response body.

  • HTTP Status Code

    HTTP/1.1 200 OK

  • Operation-specific response headers

    None. For information about common response parameters, see Common parameters.

  • Response Body

    The response is in the XML format. The Queues parameter contains multiple queues. Each queue contains a QueueURL parameter. This parameter indicates the URL of the queue. If the number of queues is greater than the value of the x-mqs-number parameter, the NextMarker parameter is returned. This parameter indicates the start position of the next page to return.

Special Error

No error codes that are specific to this operation are returned. Potential errors are related to permission check and parameter settings. For more information, see Error codes.

  • Sample requests
        GET /  HTTP/1.1
        x-mqs-marker: xxxx
        x-mqs-ret-number:2
        Host: $AccountId.mqs-cn-hangzhou.aliyuncs.com
        Date: Wed, 08 Mar 2012 12:00:00 GMT
        x-mqs-version: 2014-07-08
        Authorization: MQS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=            
  • Sample success responses
        HTTP/1.1 200OK
        x-mqs-request-id:512B2A634403E52B1956133E 
        x-mqs-version: 2015-06-06
        <? xml version="1.0" encoding="UTF-8" &nbsp;? >
        <Queues xmlns="http://mqs.aliyuncs.com/doc/v1/">
        <Queue>
            < QueueURL>
                http:// $AccountId.mqs-cn-hangzhou.aliyuncs.com/queueName
            </ QueueURL>
        </Queue>
        <Queue>
        < QueueURL>
                  http:// $AccountId.mqs-cn-hangzhou.aliyuncs.com/queueName1
        </ QueueURL>
        </Queue>
        <NextMarker> Base64 Encoded Result </NextMarker>
        </Queues>