此接口用于列出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>