基本信息
描述
该接口用于消费者批量查看消息,一次最多查看16条消息。BatchPeekMessage 与 BatchReceiveMessage 不同, BatchPeekMessage 并不会改变消息的状态,即被 BatchPeekMessage 获取消息后消息仍然处于 Active 状态,仍然可被查看或消费;而后者操作成功后消息进入 Inactive,在 VisibilityTimeout 的时间内不可被查看和消费。
Request
Request的构造主要由以下几个部分组成:
请求行
GET /queues/$queueName/messages?peekonly=true&numOfMessages=16 HTTP/1.1
特有URI参数
特有Request Header
无,请参考 [backcolor=transparent]调用方式/公共参数
Request Body
无
Response
返回消息由返回状态行,HTTP头和消息体三部分组成。
HTTP Status Code
HTTP/1.1 200 OK
特有Response Header
无,请参考 [backcolor=transparent]调用方式/公共参数
Response Body
返回的结果为XML格式,返回多条Message消息正文及消息属性。
Special Error
[backcolor=transparent]请求示例:
[backcolor=transparent]