傳送訊息批次

發行項
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

另請參閱

服務匯流排 HTTP 用戶端範例

共用方式為