Ta bort meddelande (Azure Storage)

  • Artikel

Åtgärden Delete Message tar bort det angivna meddelandet från kön.

Förfrågan

Du kan skapa begäran på Delete Message följande sätt. HTTPS rekommenderas.

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

Ersätt myaccount med namnet på ditt lagringskonto med myqueue namnet på kön och string-value med värdet för det popkvitto som har hämtats för att meddelandet ska tas bort.

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:10001, fö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/messageid?popreceipt=string-value HTTP/1.1

URI-parametrar

Begärande-URI:n stöder följande parametrar.

Parameter Beskrivning
popreceipt Krävs. Ett giltigt popkvittovärde som returnerades från ett tidigare anrop till åtgärden Hämta meddelanden eller Uppdatera meddelande .
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för kölagringså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 loggningen 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 statuskoden 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 standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Begärandehuvud Description
x-ms-request-id Det här huvudet identifierar unikt den begäran som gjordes 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änds för att köra begäran. Det här huvudet returneras för begäranden mot version 2009-09-19 och senare.
Date Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Tjänsten genererar det här värdet.
x-ms-client-request-id Det här huvudet 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 för x-ms-client-request-id huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. x-ms-client-request-id Om rubriken inte finns i begäran visas inte det här huvudet i svaret.

Själva svaret

Inga.

Auktorisering

Kontoägaren kan utföra den här åtgärden. Dessutom kan alla med en signatur för delad åtkomst som har behörighet att utföra den här åtgärden utföra den.

Kommentarer

När du har tagit bort ett meddelande markeras det omedelbart för borttagning och är inte längre tillgängligt för klienter. Meddelandet tas senare bort från kön under skräpinsamlingen.

När en klient hämtar ett meddelande med åtgärden Hämta meddelanden förväntas klienten bearbeta och ta bort meddelandet. Om du vill ta bort meddelandet måste du ha två dataobjekt som returneras i åtgärdens Get Messages svarstext:

  • Meddelande-ID:t, ett täckande GUID-värde som identifierar meddelandet i kön.

  • Ett giltigt popkvitto, ett täckande värde som anger att meddelandet har hämtats.

Meddelande-ID:t returneras från föregående Get Messages åtgärd. Popkvittot returneras från den senaste Get Messages åtgärden eller Update Message åtgärden. Delete Message För att åtgärden ska lyckas måste popkvittot som anges i begäran matcha popkvittot som returneras från Get Messages åtgärden eller Update Message .

Popkvitton förblir giltiga tills någon av följande händelser inträffar:

  • Meddelandet upphör att gälla.

  • Meddelandet tas bort med hjälp av det senaste popkvittot som togs emot, antingen från Get Messages eller Update Message.

  • Tidsgränsen för osynlighet upphör att gälla och meddelandet raderas av en Get Messages begäran. När tidsgränsen för osynlighet upphör att gälla visas meddelandet igen. Om det hämtas av en annan Get Messages begäran kan det returnerade popkvittot användas för att ta bort eller uppdatera meddelandet.

  • Meddelandet uppdateras med en ny tidsgräns för synlighet. När meddelandet uppdateras returneras ett nytt popkvitto.

Om ett meddelande med ett matchande pop-kvitto inte hittas returnerar tjänsten felkoden 404 (hittades inte). Det här felet uppstår i de tidigare angivna fallen där popkvittot inte längre är giltigt.

Se även

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