Przywracanie udziału
Operacja Restore Share przywraca (lub cofa) udział, który został wcześniej usunięty nietrwale. Ten interfejs API jest w pełni obsługiwany, ale jest to starszy interfejs API zarządzania. Zamiast tego użyj udziałów plików — przywracanie dostarczone przez dostawcę zasobów magazynu (Microsoft.Storage). Aby dowiedzieć się więcej o programowej interakcji z FileShare zasobami przy użyciu dostawcy zasobów magazynu, zobacz Operacje na udziałach plików.
Udział jest przywracany wraz ze wszystkimi jego danymi, metadanymi i migawkami. Zasób udziału zawiera metadane i właściwości udziału.
Dostępność protokołu
| Włączony protokół udziału plików | Dostępne |
|---|---|
| SMB |
|
| NFS |
|
Żądanie
Żądanie można skonstruować Restore 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/restoredShareName?restype=share&comp=undelete |
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. |
restoredShareName |
Nazwa używana dla przywróconego udziału. Jeśli udział już istnieje o tej nazwie, operacja zakończy się niepowodzeniem. |
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 limitu czasu jest wyrażony 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 uwierzytelniania, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Authentication for the Azure Storage services (Uwierzytelnianie dla usług Azure Storage). |
x-ms-date |
Wymagane. Określa godzinę uniwersalnego czasu koordynowanego (UTC) dla żądania. Aby uzyskać więcej informacji, zobacz Authentication for the Azure Storage services (Uwierzytelnianie dla usług Azure Storage). |
x-ms-version |
Wymagane dla wszystkich uwierzytelnionych żą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-deleted-share-name |
Wymagane. Identyfikuje nietrwale usunięty udział plików do przywrócenia. Ta wartość musi być zgodna z wartością .restoredShareName |
x-ms-deleted-share-version |
Wymagane. Jednoznacznie identyfikuje nietrwały udział plików usunięty przez jego wersję. |
x-ms-client-request-id |
Opcjonalny. Udostępnia 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
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=undelete HTTP/1.1
Request Headers:
x-ms-version: 2019-12-12
x-ms-deleted-share-name: myshare
x-ms-deleted-share-version: 01D2AC0C18EDFE36
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). Jeśli docelowa nazwa udziału plików jest używana przez prawidłowy niesuszowany udział plików, żądanie zakończy się niepowodzeniem z wartością 409 (konflikt). Jeśli źródłowy udział plików nie został usunięty nietrwale, został już przywrócony lub jeśli źródłowy udział plików przekroczył okres przechowywania i wygasł, żądanie zakończy się niepowodzeniem z 404 (Nie znaleziono).
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ę udziału w cudzysłowie. |
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. Każda operacja, która modyfikuje udział lub jego właściwości lub metadane, aktualizuje czas ostatniej modyfikacji. Operacje na plikach nie wpływają na czas ostatniej modyfikacji 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ę Azure Files użytą do uruchomienia żądania. |
Date |
Wartość daty/godziny UTC wskazująca godzinę, w której zainicjowano odpowiedź. Usługa generuje tę wartość. |
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 parametru x-ms-client-request-id header, jeśli znajduje się w żądaniu. Wartość wynosi co najwyżej 1024 widoczne znaki ASCII. Jeśli element x-ms-client-request-id header 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:
x-ms-request-id: 78c46801-f01a-0089-31fb-486017000000
x-ms-version: 2019-12-12
Content-Length: 0
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autoryzacja
Właściciel konta magazynu może wywołać tę operację. Ponadto użytkownicy z prawidłowymi tokenami sygnatury dostępu współdzielonego konta mogą wywoływać tę operację. Token musi zawierać uprawnienia do zapisu dla zasobu kontenera, aby autoryzować tę operację.
Uwagi
Nie można przywrócić udziału do innej nazwy. Po przywróceniu udziału, jeśli istnieje inny udział o tej samej nazwie, operacja kończy się niepowodzeniem z kodem stanu 409 (konflikt). Udział o tej samej nazwie należy najpierw usunąć, zanim nietrwały udział może zostać niezaufany.
Po usunięciu udziału nie można przywrócić udziału o tej samej nazwie przez co najmniej 30 sekund. Podczas usuwania udziału próba przywrócenia udziału o tej samej nazwie kończy się niepowodzeniem z kodem stanu 409 (konflikt). Usługa zwraca dodatkowe informacje o błędzie wskazujące, że udział jest usuwany.