Path - Delete
Eliminar archivo | Eliminar directorio
Elimine el archivo o directorio. Esta operación admite solicitudes HTTP condicionales. Para obtener más información, consulte Especificación de encabezados condicionales para operaciones de Blob Service. Nota: La API "Path - Delete" no admite la eliminación de versiones de blobs. Para obtener más información sobre cómo eliminar blobs con versiones, consulte Eliminar blob.
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&continuation={continuation}&paginated={paginated}&timeout={timeout}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de Azure Storage. |
dns
|
path | True |
string |
Sufijo DNS para el punto de conexión de Azure Data Lake Storage. |
filesystem
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$ |
Identificador del sistema de archivos. |
path
|
path | True |
string |
Ruta de acceso del archivo o directorio. |
continuation
|
query |
string |
Opcional. Al eliminar un directorio, el número de rutas de acceso que se eliminan con cada invocación es limitada. Si el número de rutas de acceso que se van a eliminar supera este límite, se devuelve un token de continuación en este encabezado de respuesta. Cuando se devuelve un token de continuación en la respuesta, debe especificarse en una invocación posterior de la operación de eliminación para continuar eliminando el directorio. |
|
paginated
|
query |
boolean |
Opcional y válido solo si el espacio de nombres jerárquico está habilitado para la cuenta y el recurso es un directorio con el parámetro de consulta "recursivo" establecido en "true". Para la eliminación de directorio recursivo, el número de rutas de acceso que se pueden eliminar con cada invocación se limita cuando el mecanismo de autorización usado es ACL y el autor de la llamada es un usuario no superusuario, ya que el tiempo de espera predeterminado es de 30 segundos. Cuando el parámetro de consulta "paginado" se establece en "true", el encabezado de respuesta puede contener "x-ms-continuation" si se alcanza el límite anterior. Al enviar el parámetro de consulta "x-ms-continuation" en la solicitud subsequnt, el parámetro de consulta "paginado" y "recursivo" debe establecerse en "true". Cuando la respuesta no contiene ninguna "x-ms-continuation", la eliminación de directorio recursiva se realiza correctamente. La eliminación del directorio real solo se produce en la última invocación, las anteriores implican comprobaciones de ACL en el servidor de los archivos y directorios del directorio que se van a eliminar de forma recursiva. |
|
recursive
|
query |
boolean |
Obligatorio y válido solo cuando el recurso es un directorio. Si es "true", se eliminarán todas las rutas de acceso debajo del directorio. Si "false" y el directorio no están vacíos, se produce un error. |
|
timeout
|
query |
integer (int32) minimum: 1 |
Valor de tiempo de espera de operación opcional en segundos. El período comienza cuando el servicio recibe la solicitud. Si el valor de tiempo de espera transcurre antes de que se complete la operación, se produce un error en la operación. |
Encabezado de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
x-ms-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
El identificador de concesión debe especificarse si hay una concesión activa. |
|
If-Match |
string |
Opcional. Un valor ETag. Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado. El ETag debe especificarse entre comillas. |
|
If-None-Match |
string |
Opcional. Un valor ETag o el carácter comodín especial ("*"). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. El ETag debe especificarse entre comillas. |
|
If-Modified-Since |
string |
Opcional. Valor de fecha y hora. Especifique este encabezado para realizar la operación solo si el recurso se ha modificado desde la fecha y hora especificadas. |
|
If-Unmodified-Since |
string |
Opcional. Valor de fecha y hora. Especifique este encabezado para realizar la operación solo si el recurso no se ha modificado desde la fecha y hora especificadas. |
|
x-ms-client-request-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
UuID registrado en los registros de análisis para solucionar problemas y correlación. |
|
x-ms-date |
string |
Especifica la hora universal coordinada (UTC) de la solicitud. Esto es necesario cuando se usa la autorización de clave compartida. |
|
x-ms-version |
string |
Especifica la versión del protocolo REST que se usa para procesar la solicitud. Esto es necesario cuando se usa la autorización de clave compartida. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Se eliminó el archivo. Encabezados
|
|
202 Accepted |
Se acepta la solicitud de eliminación, aplicable solo cuando el espacio de nombres jerárquico está habilitado para la cuenta. Encabezados
|
|
Other Status Codes |
Se ha producido un error. A continuación se enumeran los posibles estados HTTP, código y cadenas de mensaje:
Encabezados
|
Definiciones
Nombre | Description |
---|---|
Data |
|
Error |
Objeto de respuesta de error del servicio. |
DataLakeStorageError
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de respuesta de error del servicio. |
Error
Objeto de respuesta de error del servicio.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error del servicio. |
message |
string |
Mensaje de error del servicio. |