Sdílená složka snímků (FileREST API) – Azure Files

Článek
06/13/2024

Počínaje verzí 2017-04-17 Snapshot Share vytvoří operace snímek sdílené složky jen pro čtení.

Dostupnost protokolu

Povolený protokol sdílených složek	K dispozici.	Stav
SMB		GA
NFS		GA

Žádost

Požadavek můžete vytvořit Snapshot 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/myshare?restype=share&comp=snapshot`	HTTP/1.1

Následujícím způsobem nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními:

Komponenta Cesta	Description
`myaccount`	Název vašeho účtu úložiště.
`myshare`	Název sdílené složky.

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 `timeout` je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Azure Files.

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 čas koordinovaného univerzálního času (UTC) požadavku. 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-meta-name:value`	Nepovinný parametr. Určuje uživatelem definovanou dvojici název-hodnota, která je přidružená k snímku sdílené složky. Pokud nezadáte žádné páry název-hodnota, operace zkopíruje metadata základní sdílené složky do snímku. Pokud zadáte jeden nebo více párů název-hodnota, vytvoří se snímek sdílené složky se zadanými metadaty. V tomto případě se metadata nezkopírují ze základní sdílené složky. Názvy metadat musí splňovat pravidla pojmenování identifikátorů jazyka C#.
`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í služby Azure Blob Storage.

Text požadavku

Žádné

Ukázkový požadavek

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1

Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
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). 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 snímku sdílené složky v uvozovkách. Snímek sdílené složky se nedá upravit, takže se `ETag` snímek konkrétní sdílené složky nikdy nezmění. Pokud jste však s `Snapshot Share` požadavkem zadali nová metadata, pak `ETag` se snímek sdílené složky liší od snímku základní sdílené složky. Pokud jste s požadavkem nezadali žádná metadata, `ETag` bude snímek sdílené složky v době pořízení snímku sdílené složky stejný jako u základní sdílené složky.
`Last-Modified`	Vrátí datum a čas poslední změny sdílené složky. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Snímek sdílené složky nelze upravit, takže čas poslední změny snímku konkrétní sdílené složky se nikdy nezmění. Pokud jste však s `Snapshot Share` požadavkem zadali nová metadata, liší se čas poslední změny snímku sdílené složky od času základní sdílené složky. Pokud jste s požadavkem nezadali žádná metadata, bude čas poslední změny snímku sdílené složky stejný jako čas vytvoření snímku základní 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 služby Azure Files použitou ke spuštění požadavku.
`Date` nebo `x-ms-date`	Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Tato služba vygeneruje tuto hodnotu.
`x-ms-snapshot`	Hodnota `DateTime` , která jednoznačně identifikuje snímek sdílené složky. Hodnotu této hlavičky můžete použít v následných požadavcích pro přístup k snímku sdílené složky. Tato hodnota je neprůrůžná.
`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` 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 v odpovědi.

Text odpovědi

Žádné

Ukázková odpověď

Response Status:
HTTP/1.1 201 Created

Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Snímky sdílených složek poskytují verze sdílených složek jen pro čtení. Po vytvoření snímku sdílené složky ho nemůžete upravit. Snímek sdílené složky poskytuje pohodlný způsob, jak vytvořit konzistentní zálohu všech souborů ve sdílené složce.

Při každém volání Snapshot Share operace se vytvoří nový snímek sdílené složky s jedinečnou DateTime hodnotou, která identifikuje snímek sdílené složky vzhledem k její základní sdílené složce. Tuto DateTime hodnotu můžete použít k provádění dalších operací se snímkem sdílené složky a jeho obsahem. Tuto DateTime hodnotu byste měli považovat za neprůchožnou.

Hodnota DateTime identifikuje snímek sdílené složky v identifikátoru URI požadavku. Například soubor v základní sdílené složce a její snímky mají identifikátory URI podobné následujícím příkladům:

Soubor ve sdílené složce: http://myaccount.file.core.windows.net/myshare/myfile
Soubor na snímku sdílené složky: http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>

Sdílená složka může podporovat vytvoření 200 snímků sdílené složky. Pokud se pokusíte vytvořit více než 200 snímků sdílených složek, vrátí služba kód chyby 409 (konflikt). Pokud se pokusíte vytvořit snímek sdílené složky, zatímco probíhá předchozí Snapshot Share operace, vrátí služba také kód chyby 409 (konflikt).

Existující snímky sdílených složek se nikdy nepřepíšou. Musí se odstranit explicitně. Pokud chcete explicitně odstranit snímky sdílené složky, zavolejte Odstranit sdílenou složku a nastavte hlavičku x-ms-include-snapshots spolu s parametrem sharesnapshot dotazu na příslušnou hodnotu.

Snímky sdílených složek NFS můžete zobrazit na klientovi NFS pomocí virtuálního adresáře snímků (.snapshot), který se obvykle nachází v kořenovém adresáři přípojného bodu sdílené složky. Přístup k tomuto adresáři je možné zakázat nastavením hlavičky x-ms-enable-snapshot-virtual-directory-access na hodnotu false v rozhraní API nastavit vlastnosti sdílené složky . Tuto hlavičku můžete také nastavit při vytváření sdílené složky v rámci operace Vytvořit sdílenou složku.

Sdílet prostřednictvím