Üzenetköteg küldése

Üzenetköteget küld egy Service Bus-üzenetsorba vagy -témakörbe.

Kérés

Metódus	Kérés URI-ja	HTTP-verzió
POST	http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath|topicPath}/messages|HTTP/1.1

Kérelemfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti. A felsorolt tulajdonságok mellett a fejléc egyéni tulajdonságokat is tartalmazhat. Lásd a példát.

Kérelem fejléce	Description
Engedélyezés	Adja meg a következő tokenértékek egyikét: Azure Active Directory (Azure AD) JSON webes jogkivonat (JWT) token. Példa: Authorization: Bearer <Azure AD JWT token>. A Azure AD-jogkivonatok létrehozásával kapcsolatos információkért lásd: Hitelesítés alkalmazásból. SAS-jogkivonat. Példa: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>. Az SAS-jogkivonatok létrehozásával kapcsolatos információkért lásd: Közös hozzáférésű jogosultságkód jogkivonat létrehozása és SAS-jogkivonat létrehozása.
Content-Type	Állítsa az application/vnd.microsoft.servicebus.json értékre.
x-ms-retrypolicy	(Nem kötelező) Állítsa be úgy, NoRetry hogy átmeneti hibák esetén letiltsa az automatikus újrapróbálkozást a küldési műveleteknél.

Kérelem törzse

A kérelem törzse tartalmazza a JSON-kódolású üzenetköteget.

Reagálás

A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.

Válaszkódok

Code	Description
201	Az üzenetsorba vagy témakörbe sikeresen elküldött üzenet.
400	Rossz kérés.
401	Engedélyezési hiba.
403	Túllépte a kvótát, vagy az üzenet túl nagy.
410	A megadott üzenetsor vagy témakör nem létezik.
500	Belső hiba történt.

Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.

Válaszfejlécek

A megadott tartalomtípus .

Válasz törzse

Nincsenek.

Példa

A következő HTTP-kérés három üzenetből álló köteget küld egy üzenetsorba vagy témakörbe. Az első üzenet TimeToLiveTimeSpan értéke 40 másodperc, a második üzenet egyéni üzenettulajdonságú "Priority", a harmadik üzenet pedig "Priority" és "Customer" egyéni üzenettulajdonságokkal rendelkezik.

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"}  
  }  
]  
  

A Service Bus a következő választ adja vissza:

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  

Lásd még:

Service Bus HTTP-ügyfélminta