Rensa meddelanden

  • Artikel

Åtgärden Clear Messages tar bort alla meddelanden från den angivna kön.

Förfrågan

Du kan skapa begäran på Clear Messages följande sätt. Vi rekommenderar HTTPS. Ersätt myaccount med namnet på ditt lagringskonto och ersätt myqueue med namnet på din kö.

Metod URI för förfrågan HTTP-version
DELETE https://myaccount.queue.core.windows.net/myqueue/messages HTTP/1.1

URI för den emulerade lagringstjänsten

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Azure Queue Storage-porten som 127.0.0.1:10001följt av namnet på det emulerade lagringskontot:

Metod URI för förfrågan HTTP-version
DELETE http://127.0.0.1:10001/devstoreaccount1/myqueue/messages HTTP/1.1

URI-parametrar

Du kan ange följande ytterligare parametrar på begärande-URI:n:

Parameter Beskrivning
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Queue Storage-åtgärder.

Begärandehuvuden

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden:

Begärandehuvud Beskrivning
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-version Valfritt. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskod 204 (inget innehåll).

Information om statuskoder finns i Status och felkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller följande rubriker. Svaret innehåller även ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Begärandehuvud Beskrivning
x-ms-request-id Identifierar begäran som gjordes unikt. Du kan använda det här huvudet för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger vilken version av Queue Storage som används för att köra begäran. Det här huvudet returneras för begäranden som görs mot version 2009-09-19 och senare.
Date Ett datum-/tidsvärde för UTC som anger den tid då tjänsten skickade svaret.
x-ms-client-request-id Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för rubriken, om det finns i begäran och värdet är högst 1 024 synliga ASCII-tecken. Om huvudet x-ms-client-request-id inte finns i begäran kommer det här huvudet inte att finnas i svaret.

Själva svaret

Inga.

Auktorisering

Endast kontoinnehavaren kan anropa den här åtgärden.

Kommentarer

Om en kö innehåller ett stort antal meddelanden Clear Messages kan tidsgränsen överskridas innan alla meddelanden har tagits bort. I det här fallet returnerar Queue Storage statuskod 500 (internt serverfel), med den ytterligare felkoden OperationTimedOut. Om du får den här felkoden kan det hända att åtgärden har slutförts på serversidan och du bör köra frågor mot servertillståndet innan du försöker utföra åtgärden igen. Om åtgärden överskrider tidsgränsen och bedöms misslyckas på serversidan bör klienten fortsätta att försöka Clear Messages igen tills den lyckas för att säkerställa att alla meddelanden har tagits bort.

Se även

Kölagringsfelkoder
Auktorisera begäranden till Azure Storage
Status- och felkoder