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 |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 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. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
share
|
path | True |
string minLength: 3maxLength: 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. |
|
subscription
|
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 |
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
Beispiel für eine Antwort
Definitionen
| Name | Beschreibung |
|---|---|
|
Cloud |
Eine Fehlerantwort des Speicherdiensts. |
|
Cloud |
Eine Fehlerantwort des Speicherdiensts. |
CloudError
Eine Fehlerantwort des Speicherdiensts.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
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 |
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. |