Obnovení kontejneru

Článek
05/15/2024

Operace Restore Container obnoví obsah a vlastnosti obnovitelně odstraněného kontejneru do zadaného kontejneru. Operace Restore Container je k dispozici ve verzi 2019-12-12 a novější.

Žádost

Žádost můžete vytvořit Restore Container pomocí platného požadavku autorizovaného pomocí sdíleného klíče, autorizace sdíleného přístupového podpisu účtu nebo řízení přístupu na základě role.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete`	HTTP/1.1
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete&sv=validsastoken`	HTTP/1.1

Parametry identifikátoru URI

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

Parametr	Popis
`restype`	Povinná hodnota. Hodnota `restype` parametru musí být `container`.
`comp`	Povinná hodnota. Hodnota `comp` parametru musí být `undelete`.
`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.

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 or 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. Určuje verzi operace, která se má pro tento požadavek použít. Pro tuto operaci musí být `2018-03-28` verze nebo novější. 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í Azure Blob Storage.
`x-ms-deleted-container-name`	Povinná hodnota. Tuto hlavičku použijete k jednoznačné identifikaci obnovitelně odstraněného kontejneru, který se má obnovit.
`x-ms-deleted-container-version`	Povinná hodnota. Tuto hlavičku použijete k jednoznačné identifikaci obnovitelně odstraněného kontejneru, který se má obnovit. Tuto hodnotu můžete získat zadáním `deleted` hodnoty v parametru `includeList Containers` dotazu operace. Další informace najdete v tématu Výpis kontejnerů.

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 201 (Vytvořeno). 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`	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`	Verze 2009-09-19 a novější. Označuje verzi Azure Blob Storage použité 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.
`Content-Length`	Délka textu požadavku. Pro tuto operaci je délka obsahu vždy nulová.

Text odpovědi

Žádné

Ukázková odpověď

Response Status:  
HTTP/1.1 201 OK  
  
Response Headers:  
Date: Mon, 15 Jun 2020 12:43:08 GMT  
x-ms-version: 2019-12-12  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0

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 Restore Container podle popisu v následujících částech.

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 Storage.

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ásledující akce RBAC jsou nezbytné pro volání operace Microsoft Entra uživatele, skupiny, spravované identity nebo instančního objektu Restore Container a předdefinované role Azure RBAC s nejnižšími oprávněními, která tuto akci zahrnuje:

Akce Azure RBAC: Microsoft.Storage/storageAccounts/blobServices/containers/write
Předdefinovaná role s nejnižšími oprávněními: 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ě sdíleného přístupového podpisu 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á klient přístup, jaká oprávnění k těmto prostředkům má a jak dlouho je SAS platný.

Operace Restore Container podporuje autorizaci pomocí SAS účtu.

Pokud je pro účet úložiště zakázaný přístup ke sdílenému klíči, 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 úč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 sdíleného přístupového podpisu pro delegování služby nebo uživatele jsou dostupné také prostřednictvím sdíleného přístupového podpisu úč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	Podepsaný typ prostředku	Podepsané oprávnění
Obnovení kontejneru	Objekt blob (b)	Kontejner (c)	Zápis (w)

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

Poznámky

Zásadu uchovávání informací o odstranění kontejneru můžete pro účet nastavit pomocí poskytovatele prostředků úložiště.
Zadaný kontejner nesmí existovat v době provedení Restore Container operace.
Pokud zadaný kontejner existuje, Restore Container operace selže s chybou 409 (Konflikt).
Pokud obnovitelně odstraněný kontejner neexistuje, už se použil jako zdroj Restore Container operace nebo pokud překročil počet dnů uchovávání, operace selže s chybou 409 (Konflikt).

Fakturace

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

Operace	Typ účtu úložiště	Kategorie fakturace
Obnovení kontejneru	Objekt blob bloku úrovně Premium Standard pro obecné účely v2 Standard pro obecné účely v1	Výpis a Create operací kontejneru

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

Sdílet prostřednictvím