Dela via


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:
  • Azure Active Directory-token (Azure AD) JSON-webbtoken (JWT).
    Exempel: Authorization: Bearer <Azure AD JWT token>.
    Information om hur du genererar en Azure AD-token finns i Autentisera från ett program.
  • En SAS-token.
    Exempel: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
    Information om hur du genererar en SAS-token finns i Generera en signaturtoken för delad åtkomst och Generera SAS-token.
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  

Se även

Service Bus HTTP-klientexempel