傳送訊息批次

將訊息批次傳送至服務匯流排佇列或主題。

要求

方法	要求 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  

另請參閱

服務匯流排 HTTP 用戶端範例