Berichtbatch verzenden

Artikel
08/05/2023

Hiermee wordt een batch berichten verzonden naar een Service Bus-wachtrij of -onderwerp.

Aanvraag

Methode	Aanvraag-URI	HTTP-versie
POST	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven. Naast de vermelde eigenschappen kan de header aangepaste eigenschappen bevatten. Zie het voorbeeld.

Aanvraagkoptekst	Description
Autorisatie	Geef een van de volgende tokenwaarden op: JSON-webtoken (JWT) van Azure Active Directory (Azure AD). Bijvoorbeeld: `Authorization: Bearer <Azure AD JWT token>`. Zie Verifiëren vanuit een toepassing voor meer informatie over het genereren van een Azure AD-token. Een SAS-token. Bijvoorbeeld: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Zie Een Shared Access Signature-token genereren en SAS-token genereren voor meer informatie over het genereren van een SAS-token.
Content-Type	Stel in op application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Optioneel) Ingesteld op `NoRetry` om automatische nieuwe pogingen bij verzendbewerkingen uit te schakelen in het geval van tijdelijke fouten.

Aanvraagbody

De aanvraagbody bevat de berichtbatch met JSON-codering.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Code	Beschrijving
201	Het bericht is verzonden naar de wachtrij of het onderwerp.
400	Ongeldige aanvraag.
401	Autorisatiefout.
403	Het quotum is overschreden of het bericht is te groot.
410	De opgegeven wachtrij of het opgegeven onderwerp bestaat niet.
500	Interne fout.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Inhoudstype zoals doorgegeven.

Hoofdtekst van antwoord

Geen.

Voorbeeld

Met de volgende HTTP-aanvraag wordt een batch van drie berichten verzonden naar een wachtrij of onderwerp. Het eerste bericht heeft een TimeToLiveTimeSpan-waarde van 40 seconden, het tweede bericht heeft een aangepaste berichteigenschap 'Prioriteit' en het derde bericht heeft de aangepaste berichteigenschappen 'Prioriteit' en 'Klant'.

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 retourneert het volgende antwoord:

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

Zie ook

Voorbeeld van Service Bus HTTP-client

Delen via