Udostępnij przez


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=2025-06-01
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2025-06-01&$include={$include}

Parametry URI

Nazwa 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

Opcjonalny. 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 dzierżawione migawki, usuwanie zakończy się niepowodzeniem. W przypadku "dzierżawionych migawek" udział plików jest usuwany wraz ze wszystkimi migawkami udziału plików (dzierżawionymi/niedzierżawionymi). W przypadku wartości "brak" udział plików jest usuwany, jeśli nie ma migawek udziału. Jeśli udział plików zawiera jakiekolwiek migawki (dzierżawione lub niedzierżawione), usuwanie zakończy się niepowodzeniem.

Nagłówek żądania

Nazwa Wymagane Typ Opis
x-ms-snapshot

string

Opcjonalnie, służy do usuwania migawki.

Odpowiedzi

Nazwa Typ Opis
200 OK

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

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
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

DeleteShares

Przykładowa prośba

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

Przykładowa odpowiedź

Definicje

Nazwa 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.

Nazwa Typ Opis
error

CloudErrorBody

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

CloudErrorBody

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

Nazwa 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.