基本信息
Name | Value |
[backcolor=transparent]API | ListQueue |
[backcolor=transparent]RAM授权操作 | mns:ListQueue |
[backcolor=transparent]资源 | acs:mns:$region:$accountid:/queues |
该接口用于列出 AccountId 下的队列列表,可分页获取数据。返回结果中只包含 QueueURL 属性,如需进一步获取消息队列的属性可以通过 GetQueueAttributes 接口(详见本文档 GetQueueAttributes 接口)获取。如果只是要获取特定前缀的队列列表,在调用此接口时指定 x-mns-prefix 参数,返回对队列名称的前缀匹配结果。
如果本次请求结果返回的消息队列总数超过本次请求的 x-mns-ret-number 参数值,返回的XML结果中包含的 NextMarker 表示下一页开始位置,在下一次请求时将该值赋予 x-mns-marker 参数以返回下一页的结果。
GET /queues HTTP/1.1
参数名称 | 说明 | 选项 |
x-mns-marker | 请求下一个分页的开始位置,一般从上次分页结果返回的NextMarker获取。 | Optional |
x-mns-ret-number | 单次请求结果的最大返回个数,可以取1-1000范围内的整数值,默认值为1000。 | Optional |
x-mns-prefix | 按照该前缀开头的 queueName 进行查找。 | Optional |
无
HTTP/1.1 200 OK
无,请参考 [backcolor=transparent]调用方式/公共参数
返回XML形式的结果,顶层 Queues 元素下包含多个 Queue 元素, Queue 元素中包含 QueueURL 元素,QueueURL 表示 Quque 的可访问 URL 地址。如果返回结果超过 x-mns-ret-number 的参数值,包含 NextMarker 元素表示下个分页的起始位置。
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。