Udział migawek

Począwszy od wersji 2017-04-17, Snapshot Share operacja tworzy migawkę udziału tylko do odczytu.

Dostępność protokołu

Włączony protokół udziału plików	Dostępne	Stan
SMB		Ogólna dostępność
NFS		Ogólna dostępność

Żądanie

Żądanie można skonstruować Snapshot Share w następujący sposób. Zalecane jest użycie protokołu HTTPS.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
PUT	https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot	HTTP/1.1

Zastąp składniki ścieżki wyświetlane we własnym identyfikatorze URI żądania, w następujący sposób:

Składnik ścieżki	Opis
myaccount	Nazwa konta magazynu.
myshare	Nazwa udziału plików.

Aby uzyskać szczegółowe informacje na temat ograniczeń nazewnictwa ścieżek, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych.

Parametry identyfikatora URI

W identyfikatorze URI żądania można określić następujący dodatkowy parametr.

Parametr	Opis
timeout	Opcjonalny. Parametr jest wyrażony timeout w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Azure Files.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania	Opis
Authorization	Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Date lub x-ms-date	Wymagane. Określa godzinę uniwersalnego czasu koordynowanego (UTC) dla żądania. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
x-ms-version	Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage.
x-ms-meta-name:value	Opcjonalny. Określa parę zdefiniowaną przez użytkownika, nazwę-wartość skojarzona z migawką udziału. Jeśli nie określisz żadnych par nazwa-wartość, operacja kopiuje metadane udziału podstawowego do migawki. Jeśli określisz jedną lub więcej par nazwa-wartość, migawka udziału zostanie utworzona z określonymi metadanymi. W takim przypadku metadane nie są kopiowane z udziału podstawowego. Nazwy metadanych muszą być zgodne z regułami nazewnictwa identyfikatorów języka C#.
x-ms-client-request-id	Opcjonalny. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z 1 limitem znaków kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitorowanie usługi Azure Blob Storage.

Treść żądania

Brak.

Przykładowe żądanie

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=

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 201 (utworzono). Aby uzyskać informacje o kodach stanu, zobacz Stan i kody błędów.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe, standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
ETag	Zawiera wartość reprezentującą wersję migawki udziału w cudzysłowie. Nie można zmodyfikować migawki udziału, więc ETag migawka określonego udziału nigdy nie zmienia się. Jeśli jednak podasz nowe metadane z Snapshot Share żądaniem, ETag migawka udziału różni się od tego udziału podstawowego. Jeśli nie określono żadnych metadanych z żądaniem, ETag migawka udziału jest identyczna z migawką udziału podstawowego, podczas wykonywania migawki udziału.
Last-Modified	Zwraca datę i godzinę ostatniej modyfikacji udziału. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty i godziny w nagłówkach. Nie można zmodyfikować migawki udziału, więc czas ostatniej modyfikacji konkretnej migawki udziału nigdy się nie zmienia. Jeśli jednak podasz nowe metadane z Snapshot Share żądaniem, czas ostatniej modyfikacji migawki udziału różni się od tego udziału podstawowego. Jeśli w żądaniu nie określono żadnych metadanych, czas ostatniej modyfikacji migawki udziału jest identyczny z migawką udziału podstawowego podczas wykonywania migawki udziału.
x-ms-request-id	Jednoznacznie identyfikuje żądanie, które zostało wykonane i może być używane do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
x-ms-version	Wskazuje wersję usługi Azure Files używaną do uruchomienia żądania.
Date lub x-ms-date	Wartość daty/godziny UTC wskazująca godzinę, w której zainicjowano odpowiedź. Usługa generuje tę wartość.
x-ms-snapshot	DateTime Wartość, która jednoznacznie identyfikuje migawkę udziału. Możesz użyć wartości tego nagłówka w kolejnych żądaniach, aby uzyskać dostęp do migawki udziału. Ta wartość jest nieprzezroczysta.
x-ms-client-request-id	Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi im odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli jest obecna w żądaniu. Wartość wynosi co najwyżej 1024 widoczne znaki ASCII. x-ms-client-request-id Jeśli nagłówek nie jest obecny w żądaniu, nie będzie on obecny w odpowiedzi.

Treść odpowiedzi

Brak.

Przykładowa odpowiedź

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

Autoryzacja

Tylko właściciel konta może wywołać tę operację.

Uwagi

Migawki udziałów zapewniają wersje udziałów tylko do odczytu. Po utworzeniu migawki udziału nie można jej modyfikować. Migawka udziału zapewnia wygodny sposób tworzenia spójnej kopii zapasowej wszystkich plików w udziale.

Za każdym razem, gdy wywołujesz operację Snapshot Share , tworzona jest nowa migawka udziału z unikatową DateTime wartością identyfikującą migawkę udziału względem jej udziału podstawowego. Tej wartości można użyć DateTime do wykonywania dalszych operacji na migawce udziału i jego zawartości. Tę wartość należy traktować DateTime jako nieprzezroczystą.

Wartość DateTime identyfikuje migawkę udziału w identyfikatorze URI żądania. Na przykład plik w udziale podstawowym i jego migawki mają identyfikatory URI podobne do następujących przykładów:

• Plik w udziale: http://myaccount.file.core.windows.net/myshare/myfile
• Plik w migawce udziału: http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>

Udział może obsługiwać tworzenie 200 migawek udziałów. Jeśli spróbujesz utworzyć więcej niż 200 migawek udziałów, usługa zwróci kod błędu 409 (Konflikt). Jeśli próbujesz utworzyć migawkę udziału, gdy poprzednia Snapshot Share operacja jest w toku, usługa zwraca również kod błędu 409 (Konflikt).

Istniejące migawki udziałów nigdy nie są zastępowane. Należy je usunąć jawnie. Aby jawnie usunąć migawki udziałów, wywołaj metodę Usuń udział i ustaw x-ms-include-snapshots nagłówek wraz z parametrem sharesnapshot zapytania na odpowiednią wartość.

Migawki udziałów NFS można wyświetlić na kliencie systemu plików NFS przy użyciu katalogu wirtualnego migawki (.snapshot), który zazwyczaj znajduje się w katalogu głównym punktu instalacji udziału. Dostęp do tego katalogu można wyłączyć, ustawiając x-ms-enable-snapshot-virtual-directory-access nagłówek na false w ustawieniu interfejsu API właściwości udziału. Możesz również ustawić ten nagłówek w momencie tworzenia udziału w ramach operacji Tworzenia udziału .