File Shares - Delete

Usuwa określony udział na jego koncie.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2026-09-01
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2026-09-01&$include={$include}

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

Nazwa konta magazynu w określonej grupie zasobów. Nazwy kont magazynu muszą mieć długość od 3 do 24 znaków i mogą zawierać wyłącznie cyfry oraz małe litery.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

shareName
path True

string

minLength: 3
maxLength: 63

Nazwa udziału plików w ramach określonego konta magazynu. Nazwy udziałów plików muszą mieć długość od 3 do 63 znaków i zawierać tylko cyfry, małe litery i myślnik (-). Każdy znak kreski (-) musi być bezpośrednio poprzedzony literą lub cyfrą i po niej następuje.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

$include
query

string

Optional. Prawidłowe wartości to: migawki, migawki dzierżawione, brak. Wartość domyślna to migawki. W przypadku "migawek" udział plików jest usuwany wraz ze wszystkimi migawkami udziału plików. Jeśli udział plików zawiera migawki dzierżawione, usunięcie zakończy się niepowodzeniem. W przypadku plików "leased-snapshots" udział plików jest usuwany, dołączane są wszystkie migawki udziału plików (dzierżawione/nieużytowane). W przypadku elementu "none" udział plików jest usuwany, jeśli nie ma migawek udziałów. Jeśli udział plików zawiera migawki (dzierżawione lub niezaleczone), usunięcie zakończy się niepowodzeniem.

Nagłówek żądania

Nazwisko Wymagane Typ Opis
x-ms-snapshot

string

Opcjonalnie, używane do usuwania migawki.

Odpowiedzi

Nazwisko Typ Opis
200 OK

Zasób został pomyślnie usunięty.

204 No Content

Zasób nie istnieje.

Other Status Codes

CloudError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko Opis
user_impersonation podszywaj się pod konto użytkownika

Przykłady

DeleteShares

Przykładowe żądanie

DELETE https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4079/providers/Microsoft.Storage/storageAccounts/sto4506/fileServices/default/shares/share9689?api-version=2026-09-01

Przykładowa odpowiedź

Definicje

Nazwisko Opis
CloudError

Odpowiedź na błąd z usługi Storage.

CloudErrorBody

Odpowiedź na błąd z usługi Storage.

CloudError

Odpowiedź na błąd z usługi Storage.

Nazwisko Typ Opis
error

CloudErrorBody

Odpowiedź na błąd z usługi Storage.

CloudErrorBody

Odpowiedź na błąd z usługi Storage.

Nazwisko Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

details

CloudErrorBody[]

Lista dodatkowych szczegółów dotyczących błędu.

message

string

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

target

string

Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie.