如何通过URL从Azure Service Bus队列批量获取未删除消息？（老C++环境）

问题根源 #

你使用的api-version=2013-08版本REST API中，GET请求批量Peek消息的逻辑存在限制——即使指定NumberOfMessages参数，默认也只会返回单条消息。要实现批量获取且不删除，需要改用POST请求配合特定端点和参数。

正确实现方式（适配2013-08 API） #

1. 请求配置

   • 请求方法：POST
   • 请求URL：

     https://mynamespace.servicebus.windows.net/myqueue/messages/head?api-version=2013-08
     

     注意：必须使用/messages/head路径，这是旧API中批量Peek的专属端点

2. 必填请求头

   • Authorization：携带SAS令牌或Azure AD认证令牌（旧API常用SAS令牌）
   • Content-Type：设置为application/atom+xml;type=entry;charset=utf-8
   • BrokerProperties：JSON格式的参数，指定批量规则：

     {"Peek": true, "MaxMessageCount": 10, "Timeout": 20}
     

     其中MaxMessageCount是你要获取的消息数量（上限32），Timeout为等待消息的超时时间（单位秒）

3. 请求体
   旧API要求POST请求必须附带空的Atom XML条目，内容如下：

   <entry xmlns="http://www.w3.org/2005/Atom">
     <content />
   </entry>
   

响应说明 #

成功请求后，会返回包含多条消息的Atom XML响应，你可以从中解析每条消息的内容。如果需要JSON格式响应，建议升级API版本到2021-05或更高，但需确认你的旧版C++库能否适配新版本的认证和格式要求。

备选方案（强制使用GET请求） #

若必须用GET请求，需升级API版本到2017-04及以上，此时GET请求支持max-message-count参数，示例URL：

https://mynamespace.servicebus.windows.net/myqueue/messages/peek/max?max-message-count=10&timeout=20&api-version=2017-04

但同样需要验证旧C++库对新版本API的兼容性。

内容的提问来源于stack exchange，提问作者ppp