Nachricht empfangen und löschen (destruktiver Lesevorgang)

Artikel
08/05/2023

Dieser Vorgang empfängt eine Nachricht aus einer Warteschlange oder einem Abonnement und entfernt die Nachricht aus dieser Warteschlange bzw. diesem Abonnement in einem automatischen Vorgang.

Anforderung

Methode	Anforderungs-URI	HTTP-Version
Delete	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head` oder `http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head\|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

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.

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.

Anforderungstext

Keine.

Antwort

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

Antwortcodes

Code	BESCHREIBUNG
200	Nachricht erfolgreich abgerufen und gelöscht.
204	Keine Nachrichten in der angegebenen Zeitüberschreitungsperiode verfügbar.
400	Ungültige Anforderung.
401	Autorisierungsfehler
410	Angegebene Warteschlange bzw. Abonnement existiert nicht.
500	Interner Fehler.

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

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antworttext

Der Antworttext ist der Nachrichtentext der abgerufenen Nachricht.

Beispiel

Die folgende HTTP-Anforderung empfängt und löscht eine Nachricht aus einer Warteschlange:

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/head?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

Service Bus gibt die folgende Antwort zurück. Die Nachricht enthält die benutzerdefinierten Eigenschaften "Priority" und "Customer":

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
BrokerProperties: {"DeliveryCount":1,"EnqueuedSequenceNumber":0,"EnqueuedTimeUtc":"Tue, 01 Jul 2014 23:00:23 GMT","Label":"M1","MessageId":"3a146f76afee41648677887ffced72d8","SequenceNumber":1,"State":"Active","TimeToLive":10}  
Priority: "High"  
Customer: "12345,ABC"  
Date: Tue, 01 Jul 2014 23:00:23 GMT  
  
12  
This is a message.  
0

Weitere Informationen

Servicebus-HTTP-Client-Beispiel

Freigeben über