Obnovit sdílenou složku
Operace Restore Share obnoví (nebo zruší) sdílenou složku, která byla dříve obnovitelně odstraněna. Toto rozhraní API je plně podporované, ale je to starší verze rozhraní API pro správu. Místo toho použijte sdílené složky – obnovení, které poskytuje poskytovatel prostředků úložiště (Microsoft.Storage). Další informace o programové interakci s prostředky pomocí poskytovatele prostředků úložiště najdete v tématu Operace se sdílenýmiFileShare složkami.
Sdílená složka se obnoví spolu se všemi svými daty, metadaty a snímky. Prostředek sdílené složky obsahuje metadata a vlastnosti sdílené složky.
Dostupnost protokolu
| Povolený protokol sdílené složky | K dispozici. |
|---|---|
| SMB |
|
| NFS |
|
Žádost
Požadavek můžete sestavit Restore Share následujícím způsobem. Doporučuje se https.
| Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete |
HTTP/1.1 |
Následujícím způsobem nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními:
| Komponenta cesty | Description |
|---|---|
myaccount |
Název vašeho účtu úložiště. |
restoredShareName |
Název, který se má použít pro obnovenou sdílenou složku. Pokud už sdílená složka s tímto názvem existuje, operace se nezdaří. |
Podrobnosti o omezeních pojmenování cest najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.
Parametry identifikátoru URI
V identifikátoru URI požadavku můžete zadat následující další parametr.
| Parametr | Popis |
|---|---|
timeout |
Nepovinný parametr. Parametr časového limitu se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files. |
Hlavičky požadavku
Následující tabulka popisuje požadovanou a volitelnou hlavičku požadavku.
| Hlavička požadavku | Popis |
|---|---|
Authorization |
Povinná hodnota. Určuje schéma ověřování, název účtu a podpis. Další informace najdete v tématu Ověřování pro služby Azure Storage. |
x-ms-date |
Povinná hodnota. Určuje čas koordinovaného univerzálního času (UTC) požadavku. Další informace najdete v tématu Ověřování pro služby Azure Storage. |
x-ms-version |
Vyžaduje se pro všechny ověřené požadavky. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage. |
x-ms-deleted-share-name |
Povinná hodnota. Identifikuje obnovitelně odstraněnou sdílenou složku, která se má obnovit. Tato hodnota musí odpovídat hodnotě restoredShareName. |
x-ms-deleted-share-version |
Povinná hodnota. Jednoznačně identifikuje obnovitelně odstraněnou sdílenou složku podle její verze. |
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é
Ukázkový požadavek
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=undelete HTTP/1.1
Request Headers:
x-ms-version: 2019-12-12
x-ms-deleted-share-name: myshare
x-ms-deleted-share-version: 01D2AC0C18EDFE36
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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). Pokud název cílové sdílené složky používá platná neodstraněná sdílená složka, požadavek selže s chybou 409 (Konflikt). Pokud zdrojová sdílená složka není obnovitelně odstraněná, už se obnovila nebo pokud uplynula doba uchovávání zdrojové sdílené složky a její platnost vypršela, požadavek selže s chybou 404 (Nenalezena).
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 |
|---|---|
ETag |
Obsahuje hodnotu, která představuje verzi sdílené složky v uvozovkách. |
Last-Modified |
Vrátí datum a čas poslední změny sdílené složky. Další informace najdete v tématu Znázornění hodnot data a času v záhlavích. Každá operace, která upraví sdílenou složku, její vlastnosti či metadata, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny sdílené složky. |
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 |
Označuje verzi Azure Files 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. |
x-ms-client-request-id |
Dá se 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 header, pokud se nachází v požadavku. Hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud požadavek x-ms-client-request-id header neobsahuje, nebude se v odpovědi vyskytovat. |
Text odpovědi
Žádné
Ukázková odpověď
Response Status:
HTTP/1.1 201 Created
Response Headers:
x-ms-request-id: 78c46801-f01a-0089-31fb-486017000000
x-ms-version: 2019-12-12
Content-Length: 0
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorizace
Tuto operaci může volat vlastník účtu úložiště. Kromě toho mohou tuto operaci volat uživatelé s platnými tokeny sdíleného přístupových podpisů účtu. Token musí obsahovat oprávnění k zápisu pro prostředek kontejneru, aby se tato operace autorizovala.
Poznámky
Sdílenou složku nemůžete obnovit pod jiným názvem. Pokud při obnovení sdílené složky existuje jiná sdílená složka se stejným názvem, operace selže se stavovým kódem 409 (konflikt). Sdílená složka se stejným názvem musí být nejprve odstraněna, aby bylo možné obnovitelně odstraněnou sdílenou složku zrušit.
Když se sdílená složka odstraní, sdílenou složku se stejným názvem není možné obnovit alespoň po dobu 30 sekund. Zatímco se sdílená složka odstraňuje, pokusy o obnovení sdílené složky se stejným názvem selžou se stavovým kódem 409 (Konflikt). Služba vrátí další informace o chybě, které označují, že se sdílená složka odstraňuje.