Path - Delete
Datei löschen | Verzeichnis löschen
Löschen Sie die Datei oder das Verzeichnis. Dieser Vorgang unterstützt bedingte HTTP-Anforderungen. Weitere Informationen finden Sie unter Specifying Conditional Headers for Blob Service Operations (Angeben von bedingten Headern für Vorgänge des Blob-Diensts).
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&continuation={continuation}&paginated={paginated}&timeout={timeout}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Azure Storage-Kontos. |
dns
|
path | True |
string |
Das DNS-Suffix für den Azure Data Lake Storage-Endpunkt. |
filesystem
|
path | True |
string |
Der Dateisystembezeichner. RegEx-Muster: |
path
|
path | True |
string |
Der Datei- oder Verzeichnispfad. |
continuation
|
query |
string |
Optional. Beim Löschen eines Verzeichnisses ist die Anzahl der Pfade, die mit jedem Aufruf gelöscht werden, begrenzt. Wenn die Anzahl der zu löschenden Pfade diesen Grenzwert überschreitet, wird in diesem Antwortheader ein Fortsetzungstoken zurückgegeben. Wenn ein Fortsetzungstoken in der Antwort zurückgegeben wird, muss es in einem nachfolgenden Aufruf des Löschvorgangs angegeben werden, um das Löschen des Verzeichnisses fortzusetzen. |
|
paginated
|
query |
boolean |
Optional und nur gültig, wenn der hierarchische Namespace für das Konto aktiviert ist und die Ressource ein Verzeichnis ist, in dem der Abfrageparameter "rekursive" auf "true" festgelegt ist. Beim rekursiven Löschen von Verzeichnissen ist die Anzahl der Pfade, die mit jedem Aufruf gelöscht werden können, begrenzt, wenn der verwendete Autorisierungsmechanismus ACL ist und der Aufrufer ein Nicht-Superbenutzer ist, da das Standardtimeout 30 Sekunden beträgt. Wenn der Abfrageparameter "paginiert" auf "true" festgelegt ist, kann der Antwortheader "x-ms-continuation" enthalten, wenn der oben genannte Grenzwert erreicht wird. Beim Senden der "x-ms-continuation" in der Untersequntanforderung sollten die Abfrageparameter "paginiert" und "rekursive" auf "true" festgelegt werden. Wenn die Antwort keine "x-ms-continuation" enthält, ist das rekursive Löschen des Verzeichnisses erfolgreich. Das eigentliche Löschen des Verzeichnisses erfolgt nur beim letzten Aufruf, die vorherigen umfassen ACL-Überprüfungen auf dem Server der Dateien und Verzeichnisse unter dem Verzeichnis, das rekursiv gelöscht werden soll. |
|
recursive
|
query |
boolean |
Erforderlich und nur gültig, wenn es sich bei der Ressource um ein Verzeichnis handelt. Wenn "true" ist, werden alle Pfade unter dem Verzeichnis gelöscht. Wenn "false" und das Verzeichnis nicht leer ist, tritt ein Fehler auf. |
|
timeout
|
query |
integer int32 |
Ein optionaler Vorgangstimeoutwert in Sekunden. Der Zeitraum beginnt, wenn die Anforderung vom Dienst empfangen wird. Wenn der Timeoutwert verstrichen ist, bevor der Vorgang abgeschlossen ist, schlägt der Vorgang fehl. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-lease-id |
string |
Die Lease-ID muss angegeben werden, wenn eine aktive Lease vorhanden ist. RegEx-Muster: |
|
If-Match |
string |
Optional. Ein ETag-Wert. Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
If-None-Match |
string |
Optional. Ein ETag-Wert oder der spezielle Wildcardwert ("*") Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Das ETag muss in Anführungszeichen angegeben werden. |
|
If-Modified-Since |
string |
Optional. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Ressource seit dem angegebenen Datum und der angegebenen Uhrzeit geändert wurde. |
|
If-Unmodified-Since |
string |
Optional. Ein Datums- und Uhrzeitwert. Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn die Ressource seit dem angegebenen Datum und der angegebenen Uhrzeit nicht geändert wurde. |
|
x-ms-client-request-id |
string |
Eine in den Analyseprotokollen für die Problembehandlung und Korrelation aufgezeichnete UUID. RegEx-Muster: |
|
x-ms-date |
string |
Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Dies ist erforderlich, wenn die Autorisierung mit gemeinsam genutzten Schlüsseln verwendet wird. |
|
x-ms-version |
string |
Gibt die Version des REST-Protokolls an, das für die Verarbeitung der Anforderung verwendet wird. Dies ist erforderlich, wenn die Autorisierung mit gemeinsam genutzten Schlüsseln verwendet wird. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Datei wurde gelöscht. Header
|
|
202 Accepted |
Die Löschanforderung wird akzeptiert und gilt nur, wenn der hierarchische Namespace für das Konto aktiviert ist. Header
|
|
Other Status Codes |
Ein Fehler ist aufgetreten. Die möglichen HTTP-status, Code und Nachrichtenzeichenfolgen sind unten aufgeführt:
Header
|
Definitionen
Name | Beschreibung |
---|---|
Data |
|
Error |
Das Dienstfehlerantwortobjekt. |
DataLakeStorageError
Name | Typ | Beschreibung |
---|---|---|
error |
Das Dienstfehlerantwortobjekt. |
Error
Das Dienstfehlerantwortobjekt.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Dienstfehlercode. |
message |
string |
Die Dienstfehlermeldung. |