Nachrichtenbatch senden

Artikel
07/19/2023

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

Anforderung

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

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben. Zusätzlich zu den aufgelisteten Eigenschaften kann der Header auch benutzerdefinierte Eigenschaften enthalten. Siehe das Beispiel.

Anforderungsheader	BESCHREIBUNG
Authorization	Geben Sie einen der folgenden Tokenwerte an: Azure Active Directory (Azure AD) JSON-Webtoken (JWT) Beispiel: `Authorization: Bearer <Azure AD JWT token>`. Informationen zum Generieren eines Azure AD-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-Tokens und Generieren eines SAS-Tokens.
Content-Type	Setzen Sie diesen Wert auf application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Optional) Legen Sie auf fest `NoRetry` , um die automatische Wiederholung von Sendevorgängen bei vorübergehenden Fehlern zu deaktivieren.

Anforderungstext

Der Anforderungstext enthält den JSON-codierten Nachrichtenbatch.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Antwortcodes

Code	BESCHREIBUNG
201	Nachricht erfolgreich an Warteschlange bzw. Thema gesendet.
400	Ungültige Anforderung.
401	Autorisierungsfehler
403	Kontingent überschritten oder Nachricht zu groß.
410	Angegebene Warteschlange bzw. Thema existiert nicht.
500	Interner Fehler.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Content-type wie übergeben.

Antworttext

Keine.

Beispiel

Die folgende HTTP-Anforderung sendet einen Batch von drei Nachrichten an eine Warteschlange oder ein Thema. Die erste Nachricht hat einen TimeToLiveTimeSpan-Wert von 40 Sekunden, die zweite Nachricht die benutzerdefinierte Nachrichteneigenschaft "Priority" und die dritte Nachricht 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

Weitere Informationen

Servicebus-HTTP-Client-Beispiel

Freigeben über