Ta bort kö (Azure Storage)
Åtgärden Delete Queue tar bort den angivna kön permanent.
Förfrågan
Du kan skapa begäran på Delete Queue följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
DELETE |
https://myaccount.queue.core.windows.net/myqueue |
HTTP/1.1 |
Emulerad lagringstjänst-URI
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 |
HTTP/1.1 |
URI-parametrar
Du kan ange följande ytterligare parameter i begärande-URI:n.
| Parameter | Beskrivning |
|---|---|
timeout |
Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ställa in tidsgränser för Queue Storage-åtgärder. |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.
| Begärandehuvud | Description |
|---|---|
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. Mer information finns i Övervaka Azure Queue Storage. |
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 kan även innehålla ytterligare STANDARD HTTP-huvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
| Svarsrubrik | Description |
|---|---|
x-ms-request-id |
Det här huvudet identifierar unikt den begäran som har gjorts och kan användas 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ändes 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å svaret initierades. Tjänsten genererar det här värdet. |
x-ms-client-request-id |
Du kan använda det här huvudet för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. Om rubriken 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
När du tar bort en kö kan du inte skapa en kö med samma namn på minst 30 sekunder. Kön kanske inte är tillgänglig på mer än 30 sekunder om tjänsten fortfarande bearbetar begäran.
När kön tas bort misslyckas försök att skapa en kö med samma namn med statuskod 409 (konflikt). Tjänsten returnerar ytterligare felinformation som anger att kön tas bort. Alla andra åtgärder, inklusive åtgärder för meddelanden i kön, misslyckas med statuskod 404 (hittades inte) medan kön tas bort.
Se även
Kölagringsfelkoder
Auktorisera begäranden till Azure Storage
Status- och felkoder