Skicka meddelandebatch
Skickar en batch med meddelanden till en Service Bus-kö eller ett ämne.
Begäran
Metod | Begärande-URI | HTTP-version |
---|---|---|
POST | http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath|topicPath}/messages|HTTP/1.1 |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden. Förutom de angivna egenskaperna kan rubriken innehålla anpassade egenskaper. Se exemplet.
Begärandehuvud | Beskrivning |
---|---|
Tillstånd | Ange något av följande tokenvärden:
|
Innehållstyp | Ange till program/vnd.microsoft.servicebus.json. |
x-ms-retrypolicy | (Valfritt) Ställ in på NoRetry för att inaktivera automatiskt återförsök vid sändningsåtgärder vid tillfälliga fel. |
Begärandetext
Begärandetexten innehåller den JSON-kodade meddelandebatchen.
Svar
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Svarskoder
Kod | Beskrivning |
---|---|
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 | Den angivna kön eller det angivna ämnet finns inte. |
500 | Internt fel. |
Information om statuskoder finns i Status och Felkoder.
Svarshuvuden
innehållstyp som skickas in.
Svarstext
Ingen.
Exempel
Följande HTTP-begäran skickar en batch med tre meddelanden till en kö eller ett ämne. Det första meddelandet har ett TimeToLiveTimeSpan värde 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