Odstranění objektu blob

  • Článek
  • 5 min ke čtení

Operace Delete Blob označí zadaný objekt blob nebo snímek k odstranění. Objekt blob se později odstraní během uvolňování paměti.

Všimněte si, že pokud chcete odstranit objekt blob, musíte odstranit všechny jeho snímky. Obě můžete odstranit současně s operací Delete Blob .

Žádost

Požadavek Delete Blob lze zkonstruovat následujícím způsobem. Doporučuje se protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště:

Identifikátor URI požadavku metody DELETE Verze PROTOKOLU HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>		 HTTP/1.1

Emulovaný identifikátor URI služby úložiště

Při vytváření požadavku na emulovanou službu úložiště zadejte název hostitele emulátoru a Blob service port jako a za ním 127.0.0.1:10000 emulovaný název účtu úložiště:

Identifikátor URI požadavku metody DELETE Verze PROTOKOLU HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

Další informace najdete v tématu Použití Azure Storage Emulator pro vývoj a testování.

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry.

Parametr Popis
snapshot Nepovinný parametr. Parametr snapshot je neprůhledná hodnota, která v případě přítomnosti určuje snímek DateTime objektu blob, který se má odstranit. Další informace o práci se snímky objektů blob najdete v tématu Vytvoření snímku objektu blob.
versionid Volitelné, verze z 12. 12. 2019 a novější. Parametr versionid je neprůhledná hodnota, která v případě přítomnosti určuje verzi objektu blob, který DateTime se má odstranit.
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 Blob Service.
deletetype Volitelné, verze 2020-02-10 nebo novější. Hodnota může deletetype být pouze permanent . Další informace najdete níže v poznámkách.

Hlavičky požadavku

Následující tabulka popisuje povinné a volitelné hlavičky požadavku.

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ů na 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ů na Azure Storage.
x-ms-version Vyžaduje se pro všechny autorizované požadavky. Další informace najdete v tématu o verzích pro Azure Storage Services.
x-ms-lease-id:<ID> Vyžaduje se, pokud má objekt blob aktivní zapůjčení.

Pokud chcete tuto operaci provést u objektu blob s aktivním zapůjčením, zadejte platné ID zapůjčení pro tuto hlavičku. Pokud v požadavku není zadané platné ID zapůjčení, operace selže se stavový kódem 403 (Zakázáno).
x-ms-delete-snapshots: {include, only} Vyžaduje se, pokud objekt blob má přidružené snímky. Zadejte jednu z následujících dvou možností:

- include: Odstraňte základní objekt blob a všechny jeho snímky.
- only: Odstraňte pouze snímky objektu blob, a ne samotný objekt blob.

Tato hlavička by měla být zadaná jenom pro požadavek na základní prostředek objektu blob. Pokud je tato hlavička zadaná v požadavku na odstranění jednotlivého snímku, Blob service stavový kód 400 (Chybný požadavek).

Pokud tato hlavička není v požadavku zadaná a objekt blob má přidružené snímky, Blob service stavový kód 409 (Konflikt).
x-ms-client-request-id Nepovinný parametr. Poskytuje neprůhlednou hodnotu vygenerovanou klientem s limitem 1 kiB znaků, který se zaznamená do analytických protokolů, když je povolené protokolování analýzy úložiště. Použití této hlavičky se důrazně doporučuje pro korelaci aktivit na straně klienta s požadavky přijatými serverem. Další informace najdete v tématu Protokolování Storage Analytics a Protokolování Azure: Použití protokolů ke sledování Storage požadavků.

Tato operace také podporuje použití podmíněných hlaviček k odstranění objektu blob pouze v případě, že je splněna zadaná podmínka. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Service.

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 202 (Přijato).

Informace o stavových kódech najdete v tématu Stavové a chybové kódy.

Hlavičky odpovědi

Odpověď pro tuto operaci zahrnuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky PROTOKOLU HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Popis
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ho 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 Blob service, která se používá k provedení požadavku. Tato hlavička se vrátí pro požadavky na verzi 2009-09-19 a vyšší.
x-ms-delete-type-permanent Pro verze 29. 7. 2017 a novější vrátí Blob service hodnotu true, pokud byl objekt blob trvale odstraněn, a hodnotu false, pokud se objekt blob odstranil jen s možností odstranění.
Date Hodnota data a času UTC vygenerovaná službou, která udává čas zahájení odpovědi.
x-ms-client-request-id Tato hlavička se používá k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky, pokud se nachází v požadavku a hodnota je nejvíce x-ms-client-request-id 1 024 viditelných znaků ASCII. Pokud hlavička v požadavku není, nebude tato hlavička x-ms-client-request-id v odpovědi k dispozici.

Autorizace

Tuto operaci může provést vlastník účtu nebo kdokoli, kdo používá sdílený přístupový podpis s oprávněním k odstranění objektu blob.

Poznámky

Pokud má objekt blob aktivní zapůjčení, klient musí v požadavku zadat platné ID zapůjčení, aby ho mohl odstranit.

Pokud má objekt blob velký počet snímků, je možné, že dojde Delete Blob k časovému limitu operace. Pokud k tomu dojde, klient by měl požadavek zopakovat.

Pro verzi 2013-08-15 a novější může klient volat k odstranění Delete Blob nepotuřené objekty blob. Nepotrzený objekt blob je objekt blob, který byl vytvořen pomocí volání operace Put Block, ale nikdy nebyl potvrzen pomocí operace Put Block List. Pro starší verze musí klient před odstraněním nejprve potvrdit objekt blob.

Funkce softwarového odstranění je zakázaná.

Když se objekt blob úspěšně odstraní, okamžitě se odebere z indexu účtu úložiště a už není přístupný klientům. Data objektu blob se později ze služby během uvolňování paměti odebrala.

Povolená funkce pro softwarové odstranění

Když se objekt blob úspěšně odstraní, odstraní se automaticky a už není přístupný pro klienty. Vlastnost Blob service uchovává objekt blob nebo snímek po dobu, po které je zadaný počet dní pro vlastnost DeleteRetentionPolicy objektu Blob service. Informace o čtení vlastností Blob service najdete v tématu Nastavení vlastností služby Blob Service.

Po zadaném počtu dnů se data objektu blob během uvolňování paměti ze služby odebrala. Objekt blob nebo snímek s možností obnovení je přístupný voláním operace List Blobs (Seznam objektů blob) a zadáním include=deleted možnosti .

Obnovite odstraněný objekt blob nebo snímek je možné obnovit pomocí příkazu Undelete Blob.

V případě jakékoli jiné operace s objektem blob nebo snímkem, které se odstraněny zpětně, vrátí služba Blob Service chybu 404 (ResourceNotFound).

Trvalé odstranění

Do rozhraní API pro odstranění objektů blob s verzí 2020-02-10 a novější byla přidána funkce pro trvalé odstranění snímku nebo verze. Aby bylo možné tuto funkci využít, musí mít účet úložiště povolené trvalé odstranění. Další informace najdete v tématu Nastavení vlastností služby Blob Service.

Storage účty s povoleným trvalým odstraněním mohou k trvalému odstranění snímku nebo odstraněné verze objektu blob použít parametr deletetype=permanent dotazu. Blob service by vrátila hodnotu 409 (Konflikt), pokud parametr dotazu obsahuje některý z následujících parametrů:

  • Trvalé odstranění není pro účet úložiště povolené.
  • Ani versionid snapshot nejsou k dispozici.
  • Zadaný snímek nebo verze se (soft) odstraní.

Trvalé odstranění také zahrnuje nové oprávnění SAS (y) k trvalému odstranění snímku objektu blob nebo verze objektu blob. Další informace najdete v tématu Vytvoření SAS služby.

Viz také

Autorizace požadavků na Azure Storage
Stavové a chybové kódy
Kódy chyb služby Blob Service – Obnovení objektů blob seznamu objektů blob