Freigeben über


Empfangen und Löschen von Nachrichten (destruktives Lesen)

Dieser Vorgang empfängt eine Nachricht aus einer Warteschlange oder einem Abonnement und entfernt die Nachricht aus dieser Warteschlange oder dem Abonnement in einem atombasierten Vorgang.

Bitten

Methode Anforderungs-URI HTTP-Version
LÖSCHEN 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 die erforderlichen und optionalen Anforderungsheader beschrieben. Zusätzlich zu den aufgelisteten Eigenschaften kann der Header benutzerdefinierte Eigenschaften enthalten. Sehen Sie sich das Beispiel an.

Anforderungsheader Beschreibung
Ermächtigung Geben Sie einen der folgenden Tokenwerte an:

Anforderungstext

Nichts.

Antwort

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

Antwortcodes

Code Beschreibung
200 Nachricht erfolgreich abgerufen und gelöscht.
204 Es sind keine Nachrichten innerhalb des angegebenen Timeoutzeitraums verfügbar.
400 Ungültige Anforderung.
401 Autorisierungsfehler.
410 Die angegebene Warteschlange oder das angegebene Abonnement ist nicht vorhanden.
500 Interner Fehler.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch weitere standardmäßige HTTP-Header 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  

Siehe auch