Skicka meddelandebatch
Skickar en batch med meddelanden till en Service Bus-kö eller ett ämne.
Förfrågan
Metod | URI för förfrågan | HTTP-version |
---|---|---|
POST | http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath|topicPath}/messages|HTTP/1.1 |
Rubriker för begäran
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden. Förutom de angivna egenskaperna kan huvudet innehålla anpassade egenskaper. Se exemplet.
Begärandehuvud | Description |
---|---|
Auktorisering | Ange något av följande tokenvärden:
|
Content-Type | Ange till application/vnd.microsoft.servicebus.json. |
x-ms-retrypolicy | (Valfritt) Ange till för att NoRetry inaktivera automatiskt återförsök vid sändningsåtgärder vid tillfälliga fel. |
Begärandetext
Begärandetexten innehåller den JSON-kodade meddelandebatchen.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Svarskoder
Kod | Description |
---|---|
201 | Meddelandet har skickats till kö eller ämne. |
400 | Felaktig begäran. |
401 | Auktoriseringsfel. |
403 | Kvoten har överskridits eller meddelandet är för stort. |
410 | Angiven kö eller ämne finns inte. |
500 | Internt fel. |
Information om statuskoder finns i Status och Felkoder.
Svarsrubriker
Innehållstyp som skickas in.
Svarstext
Inga.
Exempel
Följande HTTP-begäran skickar en batch med tre meddelanden till en kö eller ett ämne. Det första meddelandet har värdet TimeToLiveTimeSpan på 40 sekunder, det andra meddelandet har en anpassad meddelandeegenskap "Prioritet" och det tredje meddelandet har de anpassade meddelandeegenskaperna "Prioritet" och "Kund".
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 returnerar följande svar:
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