Freigeben über


File Shares - Delete

Löscht die angegebene Freigabe unter ihrem Konto.

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}

URI-Parameter

Name In Erforderlich Typ Beschreibung
accountName
path True

string

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

Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Speicherkontonamen müssen zwischen 3 und 24 Zeichen lang sein und dürfen nur Zahlen und Kleinbuchstaben enthalten.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

shareName
path True

string

minLength: 3
maxLength: 63

Der Name der Dateifreigabe innerhalb des angegebenen Speicherkontos. Dateifreigabenamen müssen zwischen 3 und 63 Zeichen lang sein und dürfen nur Zahlen, Kleinbuchstaben und Bindestriche (-) enthalten. Jedem Bindestrich (-) muss unmittelbar ein Buchstabe oder eine Zahl vorangestellt und gefolgt werden.

subscriptionId
path True

string (uuid)

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

$include
query

string

Wahlfrei. Gültige Werte sind: Momentaufnahmen, leased-snapshots, none. Der Standardwert ist snapshots. Bei "Momentaufnahmen" wird die Dateifreigabe einschließlich aller Momentaufnahmen der Dateifreigabe gelöscht. Wenn die Dateifreigabe geleaste Snapshots enthält, schlägt der Löschvorgang fehl. Bei 'leased-snapshots' wird die Dateifreigabe einschließlich aller ihrer Dateifreigabe-Snapshots (geleast/nicht geleast) gelöscht. Bei 'none' wird die Dateifreigabe gelöscht, wenn sie keine Freigabe-Snapshots enthält. Wenn die Dateifreigabe Snapshots (geleaste oder nicht geleaste) enthält, schlägt der Löschvorgang fehl.

Anforderungsheader

Name Erforderlich Typ Beschreibung
x-ms-snapshot

string

Optional, wird verwendet, um einen Snapshot zu löschen.

Antworten

Name Typ Beschreibung
200 OK

Ressource erfolgreich gelöscht.

204 No Content

Ressource ist nicht vorhanden.

Other Status Codes

CloudError

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

DeleteShares

Beispielanforderung

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

Beispiel für eine Antwort

Definitionen

Name Beschreibung
CloudError

Eine Fehlerantwort des Speicherdiensts.

CloudErrorBody

Eine Fehlerantwort des Speicherdiensts.

CloudError

Eine Fehlerantwort des Speicherdiensts.

Name Typ Beschreibung
error

CloudErrorBody

Eine Fehlerantwort des Speicherdiensts.

CloudErrorBody

Eine Fehlerantwort des Speicherdiensts.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.

details

CloudErrorBody[]

Eine Liste mit zusätzlichen Details zum Fehler.

message

string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

target

string

Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.