Zpráva o odstranění (Azure Storage)

  • Článek

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

Žádost

Požadavek můžete sestavit 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 potvrzení pop, 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 receipt vrácená z dřívějšího volání operace Získat zprávy nebo Aktualizovat zprávu .
timeout Nepovinný parametr. Parametr se timeout vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace 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á pro tento požadavek použít. 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 lze ji 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é proti 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 se nachází v požadavku. Hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, nebude tato hlavička v odpovědi.

Text odpovědi

Žádné

Autorizace

Tuto operaci může provést vlastník účtu. Navíc 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 přestane být přístupná klientům. Zpráva je později odebrána z fronty během uvolňování paměti.

Jakmile klient načte zprávu pomocí operace Získat zprávy , očekává se, že klient 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ě položky dat:

  • ID zprávy, neprůžný identifikátor GUID, který identifikuje zprávu ve frontě.

  • Platné potvrzení pop, neprůkazná hodnota, která označuje, že zpráva byla načtena.

ID zprávy se vrátí z předchozí Get Messages operace. Pop receipt is returned from the recent Get Messages or Update Message operation. Aby byla Delete Message operace úspěšná, musí se potvrzení pop zadané v požadavku shodovat s potvrzením pop vrácenou z Get Messages operace nebo Update Message .

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

  • Platnost zprávy vyprší.

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

  • Vypršení časového limitu neviditelnosti vyprší a požadavek zprávu z fronty vyřadit Get Messages . 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 nenajde zpráva s odpovídajícím pop účtem, vrátí služba kód chyby 404 (Nenalezena). K této chybě dochází v dříve uvedených případech, kdy potvrzení pop již není platné.

Viz také

Autorizace požadavků do Služby Azure Storage
Stavové kódy a kódy chyb
Kódy chyb queue Storage