Zrušit odstranění objektu blob

Článek
05/15/2024

Operace Undelete Blob obnoví obsah a metadata obnovitelného odstraněného objektu blob a všechny přidružené obnovitelné odstraněné snímky.

Undelete Blob je podporován pouze ve verzi 2017-07-29 nebo novější.

Žádost

Požadavek můžete vytvořit Undelete 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 PUT	Verze PROTOKOLU HTTP
`https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=undelete`	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 PUT	Verze PROTOKOLU HTTP
`http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=undelete`	HTTP/1.1

Další informace najdete v tématu Použití emulátoru Azurite pro místní vývoj služby Azure Storage.

Parametry identifikátoru URI

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

Parametr	Popis
`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 Storage.

Hlavičky požadavků (všechny typy objektů blob)

Následující tabulka popisuje požadované a volitelné hlavičky požadavků pro všechny typy objektů blob.

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`	Povinné pro všechny autorizované žádosti. 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-undelete-source`	Nepovinný parametr. Verze 2020-08-04 a novější. Pouze pro účty s povoleným hierarchickým oborem názvů. Cesta obnovitelného odstraněného objektu blob k obnovení. Formát je `blobPath?deletionid=<id>`. Název účtu a kontejneru nejsou v cestě zahrnuté. `DeletionId` je jedinečný identifikátor obnovitelného odstraněného objektu blob. Můžete ho načíst výpisem obnovitelně odstraněných objektů blob pomocí `List Blobs` rozhraní REST API pro účty povolené s hierarchickým oborem názvů. Cesta by měla být zakódovaná v procentech.
`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.

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 200 (OK). 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.

Syntax	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 Blob Storage použitou ke spuštění požadavku.
`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 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

Při volání jakékoli operace přístupu k datům ve službě Azure Storage se vyžaduje autorizace. Operaci můžete autorizovat, Undelete 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 ve srovnání s autorizací sdíleného klíče poskytuje 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í je ověřen 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.

Poznámka

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 Undelete Blob a nejméně privilegované integrované role Azure RBAC, která zahrnuje tuto akci:

Akce Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/write
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 Undelete 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.

Undelete Blob Volání operace pomocí tokenu SAS delegovaného na prostředek kontejneru vyžaduje oprávnění k zápisu (w) 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.

Undelete Blob Volání operace pomocí tokenu SAS delegovaného na prostředek kontejneru vyžaduje oprávnění k zápisu (w) 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í
Zrušit odstranění objektu blob	Objekt blob (b)	Kontejner (c)	Zápis (w)

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

Poznámky

Když obnovitelně odstraněný objekt blob zrušíte, budou objekt blob a všechny přidružené snímky k dispozici pro operace pomocí jiných rozhraní API. Když zrušíte obnovení objektu blob, který není obnovitelně odstraněný nebo nemá žádné obnovitelné odstraněné snímky, operace proběhne bez jakýchkoli změn.

Fakturace

Žádosti o ceny můžou pocházet od klientů, kteří používají rozhraní BLOB Storage API, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny Služby Azure Storage. Tyto požadavky načítají poplatky za transakci. Typ transakce ovlivňuje způsob účtování poplatku za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka ukazuje kategorii fakturace pro Undelete Blob žádosti založené na typu účtu úložiště:

Operace	Typ účtu úložiště	Kategorie fakturace
Zrušit odstranění objektu blob	Objekt blob bloku úrovně Premium Standard pro obecné účely v2 Standard pro obecné účely v1	Operace zápisu

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.

Viz také

Autorizace žádostí do Služby Azure Storage
Stavové kódy a kódy chyb Odstranění objektu blob

Sdílet prostřednictvím