Freigabe löschen

Der Delete Share Vorgang löscht die angegebene Freigabe oder freigabe Momentaufnahme. Diese API wird vollständig unterstützt, aber beachten Sie, dass es sich um eine Legacyverwaltungs-API handelt.

Es ist ratsam, stattdessen Dateifreigaben – Löschen zu verwenden. Sie wird vom Speicherressourcenanbieter (Microsoft.Storage) bereitgestellt. Weitere Informationen zur programmgesteuerten Interaktion mit FileShare Ressourcen mithilfe des Speicherressourcenanbieters finden Sie unter Vorgänge auf FileShares.

Protokollverfügbarkeit

Aktiviertes Dateifreigabeprotokoll	Verfügbar
SMB
NFS

Anforderung

Sie können die Delete Share Anforderung wie folgt erstellen. HTTPS wird empfohlen.

Methode	Anforderungs-URI	HTTP-Version
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

Ersetzen Sie die im Anforderungs-URI angezeigten Pfadkomponenten wie folgt durch Ihre eigenen Angaben:

Pfadkomponente	BESCHREIBUNG
myaccount	Der Name Ihres Speicherkontos.
myshare	Der Name der Dateifreigabe.

Ausführliche Informationen zu Pfadbenennungseinschränkungen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten.

URI-Parameter

Sie können die folgenden zusätzlichen Parameter im Anforderungs-URI angeben.

Parameter	BESCHREIBUNG
sharesnapshot	Optional. Version 2017-04-17 und höher. Der sharesnapshot Parameter ist ein undurchsichtiger DateTime Wert, der, wenn vorhanden, die zu löschende Freigabe Momentaufnahme angibt.
timeout	Optional. Der timeout-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Azure Files Vorgänge.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
Authorization	Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
Date oder x-ms-date	Erforderlich. Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
x-ms-version	Erforderlich für alle autorisierten Anforderungen. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.
x-ms-delete-snapshots: { include, include-leased }	Optional, wenn die Freigabe über zugeordnete Momentaufnahmen verfügt. Geben Sie eine der folgenden Optionen an: include: Löschen Sie die Basisfreigabe und alle zugehörigen Momentaufnahmen. include-leased: Version 2020-02-10 und höher. Löschen Sie die Basisfreigabe und alle zugehörigen Momentaufnahmen, auch wenn mindestens eine der Momentaufnahmen über aktive Freigabeleases verfügt.
x-ms-client-request-id	Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem Zeichenlimit von 1 Kibibyte (KiB) bereit, der beim Konfigurieren der Protokollierung in den Protokollen aufgezeichnet wird. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen Azure Files.
x-ms-lease-id: <ID>	Erforderlich, wenn die Zieldateifreigabe über eine aktive Lease verfügt. Verfügbar für Version 2020-02-10 und höher. Wenn die Anforderung die Lease-ID nicht enthält oder ungültig ist, schlägt der Vorgang mit status Code 412 (Vorbedingung fehlgeschlagen) fehl. Wenn dieser Header angegeben ist und die Zieldateifreigabe derzeit keine aktive Lease aufweist, schlägt der Vorgang auch mit status Code 412 (Vorbedingung fehlgeschlagen) fehl.

Anforderungstext

Keine.

Beispiel für eine Anforderung

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  

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 202 (Akzeptiert) zurück. Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann auch zusätzliche HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader	BESCHREIBUNG
x-ms-request-id	Dieser Header identifiziert eindeutig die Anforderung, die gestellt wurde, und kann für die Problembehandlung der Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
x-ms-version	Gibt die Version von Azure Files an, die zum Ausführen der Anforderung verwendet wird.
Date oder x-ms-date	Ein UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. Der Dienst generiert diesen Wert.
x-ms-client-request-id	Sie können diesen Header verwenden, um Probleme mit Anforderungen und entsprechenden Antworten zu beheben. Der Wert dieses Headers entspricht dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist. Der Wert ist höchstens 1.024 sichtbare ASCII-Zeichen. Wenn der x-ms-client-request-id Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden.

Antworttext

Keine.

Authorization

Nur der Kontobesitzer kann diesen Vorgang aufrufen.

Hinweise

Wenn Sie eine Freigabe löschen, können Sie keine Freigabe mit demselben Namen für mindestens 30 Sekunden erstellen. Während die Freigabe gelöscht wird, schlagen Versuche, eine Freigabe desselben Namens erneut zu erstellen, mit status Code 409 (Konflikt) fehl. Der Dienst gibt zusätzliche Fehlerinformationen zurück, die angeben, dass die Freigabe gelöscht wird. Alle anderen Vorgänge, einschließlich von Vorgängen für beliebige Dateien unter der Freigabe, schlagen mit dem Statuscode "404 (Nicht gefunden)" fehl, während die Freigabe gelöscht wird.

Derzeit ist das Löschen einer Freigabe mit Momentaufnahmen nicht zulässig. Die Freigabemomentaufnahmen können mithilfe des Headers einzeln oder zusammen mit der x-ms-delete-snapshots=include Freigabe gelöscht werden.

Sie sollten nur für eine Anforderung für die Basisfreigaberessource angeben x-ms-delete-snapshots . Wenn Sie diesen Header für eine Anforderung zum Löschen eines einzelnen Momentaufnahme angeben, gibt Azure Files status Code 400 (Ungültiger Abfrageparameterwert) zurück. Wenn dieser Header nicht in der Löschanforderung angegeben ist und die Freigabe über zugeordnete Momentaufnahmen verfügt, gibt der Azure Files status Code 409 (Freigabe hat Momentaufnahmen) zurück.

Weitere Informationen

Vorgänge für Freigaben (Azure Files)