Udostępnij za pośrednictwem


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 Tak
NFS Tak

Żą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:
  • include: Usuń udział podstawowy i wszystkie jego migawki.
  • include-leased: wersja 2020-02-10 lub nowsza. Usuń udział podstawowy i wszystkie jego migawki, nawet jeśli co najmniej jedna migawka ma aktywne dzierżawy udziałów.
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).

Zobacz też

Operacje na udziałach (Azure Files)