Usuń udział
Operacja Delete Share
usuwa określony udział lub migawkę udziału. Ten interfejs API jest w pełni obsługiwany, ale należy pamiętać, że jest to starszy interfejs API zarządzania.
Dobrym pomysłem jest użycie udziałów plików — zamiast tego usuń. Jest on dostarczany 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.
Dostępność protokołu
Włączony protokół udziału plików | Dostępne |
---|---|
SMB | |
NFS |
Żądanie
Żądanie można skonstruować Delete Share
w następujący sposób. Zalecane jest użycie protokołu HTTPS.
Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
---|---|---|
DELETE |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
DELETE |
https://myaccount.file.core.windows.net/myshare?sharesnapshot=<DateTime>&restype=share |
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
W identyfikatorze URI żądania można określić następujące dodatkowe parametry.
Parametr | Opis |
---|---|
sharesnapshot |
Opcjonalny. Wersja 2017-04-17 lub nowsza. Parametr sharesnapshot jest nieprzezroczystą DateTime wartością, która w chwili obecnej określa migawkę udziału do usunięcia. |
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 dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). 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-delete-snapshots: { include, include-leased } |
Opcjonalnie, jeśli udział ma skojarzone migawki. Określ jedną z następujących opcji:
|
x-ms-client-request-id |
Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB) rejestrowanym 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 Files. |
x-ms-lease-id: <ID> |
Wymagane, jeśli docelowy udział plików ma aktywną dzierżawę. Dostępne dla wersji 2020-02-10 lub nowszej. Jeśli żądanie nie zawiera identyfikatora dzierżawy lub jest nieprawidłowe, operacja kończy się niepowodzeniem z kodem stanu 412 (Niepowodzenie warunku wstępnego). Jeśli ten nagłówek jest określony, a docelowy udział plików nie ma obecnie aktywnej dzierżawy, operacja zakończy się niepowodzeniem z kodem stanu 412 (Niepowodzenie warunku wstępnego). |
Treść żądania
Brak.
Przykładowe żądanie
DELETE https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ= TBD
Reakcja
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kod stanu
Operacja zakończona powodzeniem zwraca kod stanu 202 (Zaakceptowano). 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 |
---|---|
x-ms-request-id |
Ten nagłówek jednoznacznie identyfikuje wykonane żądanie 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-client-request-id |
Ten nagłówek służy do rozwiązywania problemów z żądaniami i odpowiadającymi im 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 istnieje w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi. |
Treść odpowiedzi
Brak.
Autoryzacja
Tylko właściciel konta może wywołać tę operację.
Uwagi
Po usunięciu udziału nie można utworzyć udziału o tej samej nazwie przez co najmniej 30 sekund. Podczas usuwania udziału próba ponownego utworzenia udziału o tej samej nazwie zakończy się niepowodzeniem z kodem stanu 409 (Konflikt). Usługa zwraca dodatkowe informacje o błędzie wskazujące, że udział jest usuwany. Wszystkie inne operacje, w tym operacje na wszystkich plikach znajdujących się w udziale, kończą się niepowodzeniem z kodem stanu 404 (Nie znaleziono), gdy udział jest usuwany.
Obecnie usuwanie udziału z migawkami jest niedozwolone. Migawki udziału można usuwać indywidualnie lub usuwać razem z udziałem za pomocą nagłówka x-ms-delete-snapshots=include
.
Należy określić x-ms-delete-snapshots
tylko żądanie względem zasobu podstawowego udziału. Jeśli określisz ten nagłówek na żądanie usunięcia pojedynczej migawki, Azure Files zwróci kod stanu 400 (nieprawidłowa wartość parametru zapytania). Jeśli ten nagłówek nie jest określony w żądaniu usuwania, a udział ma skojarzone migawki, Azure Files zwraca kod stanu 409 (Migawki udziału).