Odstranit zprávu (Azure Storage)

  • Článek

Operace Delete Message odstraní zadanou zprávu z fronty.

Žádost

Požadavek můžete vytvořit Delete Message následujícím způsobem. Doporučuje se https.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
DELETE https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Nahraďte myaccount názvem vašeho účtu úložiště, myqueue názvem vaší fronty a string-value hodnotou pop účtenky, která byla získána pro odstranění zprávy.

Identifikátor URI služby emulovaného úložiště

Když vytvoříte požadavek na službu emulovaného úložiště, zadejte název hostitele emulátoru a port služby Azure Queue Storage jako 127.0.0.1:10001a název emulovaného účtu úložiště.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
DELETE http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Parametry identifikátoru URI

Identifikátor URI požadavku podporuje následující parametry.

Parametr Popis
popreceipt Povinná hodnota. Platná hodnota pop potvrzení vrácená z dřívějšího volání operace Získat zprávy nebo Aktualizovat zprávu .
timeout Nepovinný parametr. Parametr timeout je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Queue Storage.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Nepovinný parametr. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Queue Storage.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 204 (bez obsahu). Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď obsahuje také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička požadavku Description
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a dá se použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi služby Queue Storage použitou ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené ve verzi 2009-09-19 a novější.
Date Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Tato služba vygeneruje tuto hodnotu.
x-ms-client-request-id Tato hlavička se dá použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku. Hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude tato hlavička v odpovědi.

Text odpovědi

Žádné

Autorizace

Tuto operaci může provést vlastník účtu. Kromě toho ji může provést kdokoli se sdíleným přístupovým podpisem, který má oprávnění k provedení této operace.

Poznámky

Když zprávu úspěšně odstraníte, okamžitě se označí k odstranění a už nebude dostupná.

Jakmile klient načte zprávu pomocí operace Získat zprávy , očekává se, že zprávu zpracuje a odstraní. Pokud chcete zprávu odstranit, musíte mít v textu Get Messages odpovědi na operaci vrácené dvě datové položky:

  • ID zprávy, neprůselná hodnota GUID, která identifikuje zprávu ve frontě.

  • Platná pop účtenka, neprůselná hodnota, která označuje, že zpráva byla načtena.

ID zprávy se vrátí z předchozí Get Messages operace. Potvrzení o popu se vrátí z poslední Get Messages operace nebo Update Message operace. Aby byla Delete Message operace úspěšná, musí se potvrzení o popu zadané v požadavku shodovat s potvrzením o popu vrácenou z Get Messages operace nebo Update Message .

Potvrzení o pop zůstávají platná, dokud nedojde k jedné z následujících událostí:

  • Platnost zprávy vyprší.

  • Zpráva se odstraní pomocí posledního přijatého pop potvrzení, buď od Get Messages nebo Update Message.

  • Vypršení časového limitu Get Messages neviditelnosti vyprší a žádost zprávu zruší. Po vypršení časového limitu neviditelnosti se zpráva znovu zobrazí. Pokud ho načte jiný Get Messages požadavek, můžete vrácené pop potvrzení použít k odstranění nebo aktualizaci zprávy.

  • Zpráva se aktualizuje o nový časový limit viditelnosti. Po aktualizaci zprávy se vrátí nové pop potvrzení.

Pokud se zpráva s odpovídající pop účtenkou nenajde, vrátí služba kód chyby 404 (Nenalezena). K této chybě dochází v dříve uvedených případech, ve kterých už potvrzení pop není platné.

Viz také

Autorizace žádostí do Služby Azure Storage
Stavové kódy a kódy chyb
Kódy chyb služby Queue Storage