Löschen von Nachrichten

  • Artikel

Der Clear Messages-Vorgang löscht alle Nachrichten aus der angegebenen Warteschlange.

Anforderung

Sie können die Clear Messages Anforderung wie folgt erstellen. Wir empfehlen HTTPS. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos, und ersetzen Sie myqueue durch den Namen Ihrer Warteschlange.

Methode Anforderungs-URI HTTP-Version
DELETE https://myaccount.queue.core.windows.net/myqueue/messages HTTP/1.1

URI für den emulierten Speicherdienst

Wenn Sie eine Anforderung für den emulierten Speicherdienst stellen, geben Sie den Emulatorhostnamen und den Azure Queue Storage-Port als 127.0.0.1:10001an, gefolgt vom Namen des emulierten Speicherkontos:

Methode Anforderungs-URI HTTP-Version
DELETE http://127.0.0.1:10001/devstoreaccount1/myqueue/messages HTTP/1.1

URI-Parameter

Sie können im Anforderungs-URI die folgenden zusätzlichen Parameter angeben:

Parameter BESCHREIBUNG
timeout Optional. Der timeout-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Warteschlangenspeichervorgänge.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben:

Anforderungsheader BESCHREIBUNG
Authorization Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
Date oder x-ms-date Erforderlich. Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
x-ms-version Optional. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.
x-ms-client-request-id Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichenlimit von 1 Kibibyte (KiB) bereit, der beim Konfigurieren der Protokollierung in den Protokollen aufgezeichnet wird. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt.

Anforderungstext

Keine

Antwort

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

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 204 (Kein Inhalt) zurückgegeben.

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

Antwortheader

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

Anforderungsheader BESCHREIBUNG
x-ms-request-id Identifiziert eindeutig die Anforderung, die gestellt wurde. Sie können diesen Header verwenden, um probleme mit der Anforderung zu beheben. Weitere Informationen finden Sie unter Problembehandlung bei API-Vorgängen.
x-ms-version Gibt die Version von Warteschlangenspeicher an, die zum Ausführen der Anforderung verwendet wird. Dieser Header wird für Anforderungen zurückgegeben, die für Version 2009-09-19 und höher erfolgen.
Date Ein UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der der Dienst die Antwort gesendet hat.
x-ms-client-request-id Kann verwendet werden, um Anforderungen und entsprechende Antworten zu behandeln. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert höchstens 1.024 sichtbare ASCII-Zeichen aufweist. Wenn der x-ms-client-request-id Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden.

Antworttext

Keine

Authorization

Nur der Kontobesitzer kann diesen Vorgang aufrufen.

Bemerkungen

Wenn eine Warteschlange eine große Anzahl von Nachrichten enthält, kann ein Timeout auftreten, Clear Messages bevor alle Nachrichten gelöscht wurden. In diesem Fall gibt Queue Storage status Code 500 (Interner Serverfehler) mit dem zusätzlichen Fehlercode OperationTimedOut zurück. Wenn Sie diesen Fehlercode erhalten, ist der Vorgang auf der Serverseite möglicherweise erfolgreich, oder nicht, und Sie sollten den Serverstatus abfragen, bevor Sie den Vorgang wiederholen. Wenn für den Vorgang ein Timeout auftritt und auf der Serverseite festgestellt wird, dass er nicht erfolgreich ist, sollte der Client es wiederholen Clear Messages , bis er erfolgreich ist, um sicherzustellen, dass alle Nachrichten gelöscht wurden.

Siehe auch

Warteschlangenspeicherfehlercodes
Autorisieren von Anforderungen an Azure Storage
Status- und Fehlercodes