Path - Delete
Excluir Arquivo | Excluir Diretório
Exclua o arquivo ou diretório. Essa operação dá suporte a solicitações HTTP condicionais. Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&continuation={continuation}&paginated={paginated}&timeout={timeout}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta do Armazenamento do Azure. |
dns
|
path | True |
string |
O sufixo DNS para o ponto de extremidade Azure Data Lake Storage. |
filesystem
|
path | True |
string |
O identificador do sistema de arquivos. Padrão Regex: |
path
|
path | True |
string |
O caminho do arquivo ou diretório. |
continuation
|
query |
string |
Opcional. Ao excluir um diretório, o número de caminhos excluídos com cada invocação é limitado. Se o número de caminhos a serem excluídos exceder esse limite, um token de continuação será retornado neste cabeçalho de resposta. Quando um token de continuação é retornado na resposta, ele deve ser especificado em uma invocação subsequente da operação de exclusão para continuar excluindo o diretório. |
|
paginated
|
query |
boolean |
Opcional e válido somente se o Namespace Hierárquico estiver habilitado para a conta e o recurso for um diretório com parâmetro de consulta "recursivo" definido como "true". Para exclusão de diretório recursivo, o número de caminhos que podem ser excluídos com cada invocação é limitado quando o mecanismo de autorização usado é ACL e o chamador é um usuário não super, pois o tempo limite padrão é de 30 segundos. Quando o parâmetro de consulta "paginado" é definido como "true", o cabeçalho de resposta pode conter "x-ms-continuation" se o limite acima for atingido. Ao enviar o parâmetro de consulta "x-ms-continuation" na solicitação subsequnt, o parâmetro de consulta "paginado" e "recursivo" deve ser definido como "true". Quando a resposta não contém nenhuma "x-ms-continuation", a exclusão do diretório recursivo é bem-sucedida. A exclusão real do diretório ocorre apenas na última invocação, as anteriores envolvem verificações de ACL no servidor dos arquivos e diretórios no diretório a serem excluídos recursivamente. |
|
recursive
|
query |
boolean |
Obrigatório e válido somente quando o recurso é um diretório. Se "true", todos os caminhos abaixo do diretório serão excluídos. Se "false" e o diretório não estiver vazio, ocorrerá um erro. |
|
timeout
|
query |
integer int32 |
Um valor de tempo limite de operação opcional em segundos. O período começa quando a solicitação é recebida pelo serviço. Se o valor de tempo limite decorrer antes da conclusão da operação, a operação falhará. |
Cabeçalho da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
x-ms-lease-id |
string |
A ID de concessão deverá ser especificada se houver uma concessão ativa. Padrão Regex: |
|
If-Match |
string |
Opcional. Um valor de ETag. Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado. A ETag deve ser especificada entre aspas. |
|
If-None-Match |
string |
Opcional. Um valor ETag ou o valor curinga especial ("*"). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso não corresponder ao valor especificado. A ETag deve ser especificada entre aspas. |
|
If-Modified-Since |
string |
Opcional. Um valor de data e hora. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a data e hora especificadas. |
|
If-Unmodified-Since |
string |
Opcional. Um valor de data e hora. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data e hora especificadas. |
|
x-ms-client-request-id |
string |
Uma UUID registrada nos logs de análise para solução de problemas e correlação. Padrão Regex: |
|
x-ms-date |
string |
Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Isso é necessário ao usar a autorização de chave compartilhada. |
|
x-ms-version |
string |
Especifica a versão do protocolo REST usada para processar a solicitação. Isso é necessário ao usar a autorização de chave compartilhada. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
O arquivo foi excluído. Cabeçalhos
|
|
202 Accepted |
A solicitação de exclusão é aceita, aplicável somente quando o Namespace Hierárquico está habilitado para a conta. Cabeçalhos
|
|
Other Status Codes |
Ocorreu um erro. As possíveis cadeias de caracteres http status, código e mensagem estão listadas abaixo:
Cabeçalhos
|
Definições
Nome | Description |
---|---|
Data |
|
Error |
O objeto de resposta de erro de serviço. |
DataLakeStorageError
Nome | Tipo | Description |
---|---|---|
error |
O objeto de resposta de erro de serviço. |
Error
O objeto de resposta de erro de serviço.
Nome | Tipo | Description |
---|---|---|
code |
string |
O código de erro do serviço. |
message |
string |
A mensagem de erro do serviço. |