你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

发送消息批

项目
08/05/2023

将一批消息发送到服务总线队列或主题。

请求

方法	请求 URI	HTTP 版本
POST	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

请求标头

下表介绍必需的和可选的请求标头。除了所列出的属性外，标头还可以包含自定义属性。请参阅示例。

请求标头	说明
授权	指定以下令牌值之一： Azure Active Directory (Azure AD) JSON Web 令牌 (JWT) 令牌。示例：`Authorization: Bearer <Azure AD JWT token>`。有关生成 Azure AD 令牌的信息，请参阅从应用程序进行身份验证。 SAS 标记。示例：`Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`。有关生成 SAS 令牌的信息，请参阅生成共享访问签名令牌和生成 SAS 令牌。
Content-Type	设置为 application/vnd.microsoft.servicebus.json。
x-ms-retrypolicy	(可选) 设置为 `NoRetry` ，以在发生暂时性错误时禁用发送操作的自动重试。

请求正文

请求正文包含 JSON 编码的消息批。

响应

响应包括 HTTP 状态代码和一组响应标头。

响应代码

代码	说明
201	已成功将消息发送到队列或主题。
400	请求错误。
401	授权失败。
403	超出了配额，或者消息太大。
410	指定的队列或主题不存在。
500	内部错误。

有关状态代码的信息，请参阅状态和错误代码。

响应标头

传入的 Content-type。

响应正文

无。

示例

以下 HTTP 请求将向队列或主题发送一个包含三条消息的批。第一条消息的 TimeToLiveTimeSpan 值为 40 秒，第二条消息具有自定义消息属性“Priority”，第三条消息具有自定义消息属性“Priority”和“Customer”。

POST https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey  
Content-Type: application/vnd.microsoft.servicebus.json  
Host: your-namespace.servicebus.windows.net  
Content-Length: 18  
Expect: 100-continue  
  
[  
  {  
    "Body":”This is the first message",  
    "BrokerProperties":{"Label":"M1","TimeToLiveTimeSpan":"0.00:00:40"}  
  },  
  {  
    "Body":”This is the second message",  
    "BrokerProperties":{"Label":"M2"},  
    "UserProperties":{"Priority":"Low"}  
  },  
  {  
    "Body":”This is the third message",  
    "BrokerProperties":{"Label":"M3"},  
    "UserProperties":{"Priority":"Medium","Customer":"ABC"}  
  }  
]

服务总线返回以下响应：

HTTP/1.1 201 Created  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:22 GMT  
  
0

另请参阅

Service Bus HTTP 客户端示例

通过