Sdílená složka snímků
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 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í 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 Azure Files použité 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ůlož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 ve 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é složky, vrátí služba kód chyby 409 (Konflikt). Pokud se pokusíte vytvořit snímek sdílené složky v průběhu 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íší. Musí se odstranit explicitně. Pokud chcete snímky sdílené složky explicitně odstranit, zavolejte příkaz Odstranit sdílenou složku a nastavte hlavičku x-ms-include-snapshots spolu s parametrem sharesnapshot dotazu na příslušnou hodnotu.