此接口用于列出AccountId下的消息队列列表,可分页获取数据。返回结果中只包含QueueURL属性,如需进一步获取消息队列的属性可以通过GetQueueAttributes接口获取。如果只是要获取特定的消息队列列表,在调用此接口时指定x-mqs-prefix参数,返回对消息队列名称的前缀匹配结果。

Request

Request的构造主要由以下几个部分组成。

  • 请求行

    GET / HTTP/1.1

  • 特有Request Header
    参数名称 说明 选项
    x-mqs-marker 请求下一个分页的开始位置,一般从上次分页结果返回的NextMarker获取。 Optional
    x-mqs-ret-number 单次请求结果的最大返回个数,可以取1~1000范围内的整数值,默认值为1000。 Optional
    x-mqs-prefix 按照该前缀开头的queueName进行查找。 Optional

    其它Request Header请参见公共参数

  • Request Body

    无。

Response

返回消息由返回状态行、HTTP头和消息体三部分组成。

  • HTTP Status Code

    HTTP/1.1 200 OK

  • 特有Response Header

    无,请参见公共参数

  • Response Body

    返回XML形式的结果,顶层Queues元素下包含多个Queue元素, Queue元素中包含QueueURL元素,QueueURL表示创建的Queue的可访问URL地址。如果返回结果超过x-mqs-ret-number的参数值,包含NextMarker元素表示下个分页的起始位置。

Special Error

本操作无特有的错误,主要是权限验证类和参数设置类错误,详情请参见错误码

  • 请求示例
        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=            
  • 返回示例
        HTTP/1.1 200OK
        x-mqs-request-id:512B2A634403E52B1956133E 
        x-mqs-version: 2015-06-06
        <?xml version="1.0" encoding=”UTF-8”  ?>
        <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>