Odstranění objektu blob

Článek
07/10/2024

Operace Delete Blob odstraní zadaný objekt blob nebo snímek.

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

Žádost

Požadavek můžete sestavit Delete Blob následujícím způsobem. Doporučuje se 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

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 Azure Blob Storage port jako 127.0.0.1:10000, následovaný názvem emulovaného úč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í emulátoru Azurite pro vývoj v místním úložišti Azure Storage.

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametry.

Parametr	Popis
`snapshot`	Nepovinný parametr. Parametr snapshot je neprůsažná `DateTime` hodnota, která určuje snímek 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 2019-12-12 a novější. Parametr `versionid` je neprůsažná `DateTime` hodnota, která pokud je k dispozici, určuje verzi objektu blob, který se má odstranit.
`timeout`	Nepovinný parametr. Parametr se `timeout` vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Storage.
`deletetype`	Volitelné, verze 2020-02-10 nebo novější. Hodnota `deletetype` může být `permanent`pouze .

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`	Vyžaduje se pro všechny autorizované žádosti. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`x-ms-lease-id:<ID>`	Vyžaduje se, pokud má objekt blob aktivní zapůjčení. Pokud chcete tuto operaci provést s objektem blob s aktivním zapůjčením, zadejte platné ID zapůjčení této hlavičky. Pokud v požadavku není zadané platné ID zapůjčení, operace selže se stavovým kódem 403 (Zakázáno).
`x-ms-delete-snapshots: {include, only}`	Vyžaduje se, pokud má objekt blob přidružené snímky. Zadejte jednu z následujících možností: - `include`: Odstraňte základní objekt blob a všechny jeho snímky. - `only`: Odstraňte jenom snímky objektu blob, a ne samotný objekt blob. Tuto hlavičku zadejte pouze pro požadavek na prostředek základního objektu blob. Pokud je tato hlavička zadaná u požadavku na odstranění jednotlivého snímku, vrátí Blob Storage 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, vrátí Blob Storage stavový kód 409 (konflikt).
`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í Azure Blob Storage.

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 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 202 (přijato). 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ěď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi	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 Blob 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ší.
`x-ms-delete-type-permanent`	Pro verzi 2017-07-29 a novější služba Blob Storage vrátí `true` , pokud se objekt blob trvale odstranil a `false` pokud byl objekt blob odstraněný obnovitelně.
`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`	Tuto hlavičku můžete 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.

Autorizace

Autorizace se vyžaduje při volání jakékoli operace přístupu k datům ve službě Azure Storage. Operaci můžete autorizovat Delete Blob , jak je popsáno níže.

Důležité

Microsoft doporučuje používat Microsoft Entra ID se spravovanými identitami k autorizaci požadavků do služby Azure Storage. Microsoft Entra ID poskytuje v porovnání s autorizací pomocí sdíleného klíče vynikající zabezpečení a snadné použití.

Azure Storage podporuje autorizaci požadavků na data objektů blob pomocí Microsoft Entra ID. S Microsoft Entra ID můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objektem zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Objekt zabezpečení ověří Microsoft Entra ID, aby vrátil token OAuth 2.0. Token se pak dá použít k autorizaci požadavku na službu Blob Service.

Další informace o autorizaci pomocí Microsoft Entra ID najdete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Oprávnění

Níže jsou uvedené akce RBAC potřebné k volání operace Microsoft Entra uživatele, skupiny, spravované identity nebo instančního objektu Delete Blob a nejméně privilegované integrované role Azure RBAC, která zahrnuje tuto akci:

Akce Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete
Nejméně privilegovaná předdefinovaná role:Přispěvatel dat v objektech blob služby Storage

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Sdílený přístupový podpis (SAS) poskytuje zabezpečený delegovaný přístup k prostředkům v účtu úložiště. V případě SAS máte podrobnou kontrolu nad tím, jak může klient přistupovat k datům. Můžete určit, k jakému prostředku může klient přistupovat, jaká oprávnění k těmto prostředkům má a jak dlouho je sas platný.

Operace Delete Blob podporuje tři typy sdílených přístupových podpisů: SAS delegování uživatele, SAS služby a SAS účtu.

Jako osvědčený postup zabezpečení doporučujeme používat přihlašovací údaje Microsoft Entra místo klíče účtu úložiště, který může být snadněji ohrožen. Pokud návrh aplikace vyžaduje sdílené přístupové podpisy, použijte přihlašovací údaje Microsoft Entra k vytvoření SAS delegování uživatele, pokud je to možné.

Pokud je přístup ke sdílenému klíči pro účet úložiště zakázaný, token SAS služby nebo token SAS účtu nebude na žádost do služby Blob Storage povolený. Další informace najdete v tématu Vysvětlení, jak zakázání sdíleného klíče ovlivňuje tokeny SAS.

SAS delegování uživatele

SAS delegování uživatele je zabezpečeno Microsoft Entra přihlašovacími údaji a také oprávněními zadanými pro SAS.

Delete Blob Volání operace pomocí tokenu SAS delegovaného na prostředek kontejneru nebo objektu blob vyžaduje oprávnění Odstranit (d) jako součást tokenu SAS delegování uživatele.

Další informace o SAS delegování uživatele najdete v tématu Create SAS delegování uživatele.

Sas služby

Sas služby je zabezpečený pomocí klíče účtu úložiště. Sas služby deleguje přístup k prostředku v jedné službě Azure Storage, jako je úložiště objektů blob.

Delete Blob Volání operace pomocí tokenu SAS delegovaného na prostředek kontejneru nebo objektu blob vyžaduje oprávnění Odstranit (d) jako součást tokenu SAS služby.

Další informace o SAS služby najdete v tématu Create SAS služby.

Sas účtu

SAS účtu je zabezpečené pomocí klíče účtu úložiště. SAS účtu deleguje přístup k prostředkům v jedné nebo více službách úložiště. Všechny operace dostupné prostřednictvím sas pro službu nebo delegování uživatele jsou dostupné také prostřednictvím SAS účtu.

Následující tabulka uvádí typ podepsaného prostředku a podepsaná oprávnění, která se mají zadat při delegování přístupu:

Operace	Podepsaná služba	Typ podepsaného prostředku	Podepsané oprávnění
Odstranění objektu blob	Objekt blob (b)	Objekt (o)	Odstranit (d)

Další informace o SAS účtu najdete v tématu Create SAS účtu.

Poznámky

Pokud má objekt blob aktivní zapůjčení, musí klient 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 Delete Blob vyprší časový limit operace. Pokud k tomu dojde, měl by klient požadavek zopakovat.

Pro verzi 2013-08-15 a novější může klient volat Delete Blob odstranění nepotvrzených objektů blob. Nepotvrzený objekt blob je objekt blob, který byl vytvořen s voláním operace Vložení bloku, ale nikdy nebyl potvrzen pomocí operace Vložit seznam bloků. U starších verzí musí klient nejprve potvrdit objekt blob, než ho odstraní.

Funkce obnovitelného odstranění je zakázaná

Když se objekt blob úspěšně odstraní, okamžitě se odebere z indexu účtu úložiště a přestane být přístupný klientům.

Povolená funkce obnovitelného odstranění

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

Po zadaném počtu dnů se data objektu blob odeberou ze služby. K obnovitelnému odstranění objektu blob nebo snímku můžete získat přístup voláním operace Výpis objektů blob a zadáním include=deleted možnosti.

Obnovitelně odstraněné objekty blob nebo snímky můžete obnovit pomocí možnosti Obnovit objekt blob. Pro jakoukoli jinou operaci s obnovitelně odstraněnými objekty blob nebo snímky vrátí služba Blob Storage chybu 404 (Prostředek se nenalezl).

Trvalé odstranění

Ve verzi 2020-02-10 a novější můžete trvale odstranit obnovitelně odstraněný snímek nebo verzi. Uděláte to tak, že tuto funkci povolíte. Další informace najdete v tématu Nastavení vlastností služby Blob Storage.

Poznámka

Účet úložiště musí mít povolenou správu verzí nebo snímky. Pro účet úložiště musí být také povolené obnovitelné odstranění, aby bylo možné obnovitelné odstranění verzí nebo snímků objektů blob v účtu. Trvalé odstranění odstraní jenom obnovitelné odstraněné snímky nebo verze.

Účty úložiště s povoleným trvalým odstraněním můžou pomocí parametru deletetype=permanent dotazu trvale odstranit obnovitelně odstraněný snímek nebo odstraněnou verzi objektu blob.

Pokud parametr dotazu obsahuje některou z následujících možností, vrátí Blob Storage chybu 409 (konflikt):

Funkce trvalého odstranění není pro účet úložiště povolená.
snapshot Ani versionid nejsou k dispozici.
Zadaný snímek nebo verze se neodstraní automaticky.

Trvalé odstranění zahrnuje také oprávnění sdíleného přístupového podpisu k trvalému odstranění snímku objektu blob nebo verze objektu blob. Další informace najdete v tématu Create SAS služby.