Udział migawek (interfejs API FileREST) — Azure Files

Artykuł
02/13/2024

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ść.

Udział migawek