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 w identyfikatorze URI żądania własnymi elementami 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
Dla identyfikatora 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 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 czas uniwersalny koordynowany (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 dla usług Azure Storage. |
x-ms-meta-name:value |
Opcjonalny. Określa zdefiniowaną przez użytkownika parę nazwa-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 co najmniej jedną 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. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1 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 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
Pomyślna operacja zwraca kod stanu 201 (Utworzony). Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i 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 standardowe nagłówki 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 się nie zmienia. Jeśli jednak nowe metadane zostały dostarczone wraz z Snapshot Share żądaniem, ETag migawka udziału różni się od tego udziału podstawowego. Jeśli w żądaniu nie określono żadnych metadanych, ETag migawka udziału jest identyczna z migawką udziału podstawowego, w czasie 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 migawki określonego udziału nigdy się nie zmienia. Jeśli jednak w żądaniu Snapshot Share podano nowe metadane, 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 tym udziałem podstawowym, w czasie wykonywania migawki udziału. |
x-ms-request-id |
Unikatowo identyfikuje żądanie, które zostało wykonane i może służyć 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ę Azure Files używaną do uruchomienia żądania. |
Date lub x-ms-date |
Wartość daty/godziny UTC wskazująca godzinę, o 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 dostępu 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 odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka x-ms-client-request-id , jeśli jest obecna w żądaniu. Wartość jest najwyżej 1024 widocznymi znakami ASCII. x-ms-client-request-id Jeśli nagłówek nie znajduje się 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 udostępniają wersje udziałów tylko do odczytu. Po utworzeniu migawki udziału nie można go zmodyfikować. 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 migawki 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łu nigdy nie są zastępowane. Muszą zostać jawnie usunięte. Aby jawnie usunąć migawki udziału, wywołaj metodę Usuń udział i ustaw x-ms-include-snapshots
nagłówek wraz z parametrem sharesnapshot
zapytania na odpowiednią wartość.