Nachrichtenbatch senden

2025-03-19

Sendet einen Batch von Nachrichten an eine ServiceBus-Warteschlange oder ein Thema.

Bitten

Methode	Anforderungs-URI	HTTP-Version
BEREITSTELLEN	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben. Zusätzlich zu den aufgelisteten Eigenschaften kann die Kopfzeile benutzerdefinierte Eigenschaften enthalten. Sehen Sie sich das Beispiel an.

Anforderungsheader	Beschreibung
Ermächtigung	Geben Sie einen der folgenden Tokenwerte an: Microsoft Entra JSON Web Token (JWT)-Token. Beispiel: `Authorization: Bearer <Azure AD JWT token>`. Informationen zum Generieren eines Microsoft Entra-Tokens finden Sie unter Authentifizieren von einer Anwendung. Ein SAS-Token. Beispiel: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Informationen zum Generieren eines SAS-Tokens finden Sie unter Generieren eines Shared Access Signature Token und Generieren von SAS-Token.
Inhaltstyp	Auf Anwendung/vnd.microsoft.servicebus.jsonfestgelegt.
x-ms-retrypolicy	(Optional) Legen Sie auf `NoRetry` fest, um den automatischen Wiederholungsversuche bei Sendevorgängen im Falle vorübergehender Fehler zu deaktivieren.

Anforderungstext

Der Anforderungstext enthält den JSON-codierten Nachrichtenbatch.

Antwort

Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.

Antwortcodes

Code	Beschreibung
201	Nachricht wurde erfolgreich an Warteschlange oder Thema gesendet.
400	Ungültige Anforderung.
401	Autorisierungsfehler.
403	Kontingent überschritten oder Nachricht zu groß.
410	Die angegebene Warteschlange oder das angegebene Thema ist nicht vorhanden.
500	Interner Fehler.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Inhaltstyp als übergeben.

Antworttext

Nichts.

Beispiel

Die folgende HTTP-Anforderung sendet einen Batch von drei Nachrichten an eine Warteschlange oder ein Thema. Die erste Nachricht verfügt über einen TimeToLiveTimeSpan Wert von 40 Sekunden, die zweite Nachricht verfügt über eine benutzerdefinierte Nachrichteneigenschaft "Priority", und die dritte Nachricht enthält die benutzerdefinierten Nachrichteneigenschaften "Priority" und "Customer".

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 gibt die folgende Antwort zurück:

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

Freigeben über