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