Odeslat dávku zpráv

Článek
08/05/2023

Odešle dávku zpráv do fronty nebo tématu služby Service Bus.

Žádost

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků. Kromě uvedených vlastností může hlavička obsahovat vlastní vlastnosti. Podívejte se na příklad.

Hlavička požadavku	Description
Autorizace	Zadejte jednu z následujících hodnot tokenu: Token AZURE Active Directory (Azure AD) JSON Web Token (JWT). Příklad: `Authorization: Bearer <Azure AD JWT token>`. Informace o vygenerování tokenu Azure AD najdete v tématu Ověřování z aplikace. Token SAS. Příklad: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Informace o vygenerování tokenu SAS najdete v tématech Generování tokenu sdíleného přístupového podpisu a Generování tokenu SAS.
Typ obsahu	Nastavte na application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Volitelné) Pokud chcete zakázat automatické opakování operací odeslání v případě přechodných chyb, nastavte na `NoRetry` hodnotu .

Text požadavku

Text požadavku obsahuje dávku zpráv zakódovanou ve formátu JSON.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Kódy odpovědí

Kód	Description
201	Zpráva byla úspěšně odeslána do fronty nebo tématu.
400	Chybný požadavek.
401	Autorizace se nezdařila.
403	Kvóta byla překročena nebo zpráva byla příliš velká.
410	Zadaná fronta nebo téma neexistuje.
500	Vnitřní chyba.

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Typ obsahu předaný.

Text odpovědi

Žádné

Příklad

Následující požadavek HTTP odešle dávku tří zpráv do fronty nebo tématu. První zpráva má hodnotu TimeToLiveTimeSpan 40 sekund, druhá zpráva má vlastní vlastnost zprávy "Priorita" a třetí zpráva má vlastní vlastnosti zprávy "Priority" a "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"}  
  }  
]

Service Bus vrátí následující odpověď:

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

Viz také

Ukázka klienta HTTP služby Service Bus

Sdílet prostřednictvím