Obnovení kontejneru

Článek
02/07/2024

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

Žádost

Požadavek 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 `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ž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`	Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. 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 jedinečné identifikaci obnovitelně odstraněného kontejneru, který se má obnovit.
`x-ms-deleted-container-version`	Povinná hodnota. Tuto hlavičku použijete k jedineč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

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 Restore Container , jak je popsáno v následujících částech.

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 ve službě 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 nebo instančního objektu Restore Container a nejméně privilegované integrované role Azure RBAC, která tuto akci zahrnuje:

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á 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 přístup ke sdílenému klíči pro účet úložiště zakázaný, 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 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í určit při delegování přístupu:

Operace	Podepsaná služba	Typ podepsaného 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 Vytvoření SAS účtu.

Poznámky

Zásady uchovávání informací pro odstranění kontejneru můžete u účtu 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, byl již použit jako zdroj Restore Container operace nebo překročil dny uchovávání, operace selže s chybou 409 (konflikt).

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 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	Operace se seznamem a vytvořením kontejneru

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