Path - Delete
Elimina file | Elimina directory
Eliminare il file o la directory. Questa operazione supporta le richieste HTTP condizionali. Per altre informazioni, vedere Specifica di intestazioni condizionali per le operazioni del servizio BLOB. Nota: l'API "Path - Delete" non supporta l'eliminazione delle versioni blob. Per altre informazioni sull'eliminazione di BLOB con versioni, vedere Eliminare BLOB.
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&continuation={continuation}&paginated={paginated}&timeout={timeout}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account di archiviazione di Azure. |
dns
|
path | True |
string |
Suffisso DNS per l'endpoint di Azure Data Lake Storage. |
filesystem
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$ |
Identificatore del file system. |
path
|
path | True |
string |
Percorso del file o della directory. |
continuation
|
query |
string |
Opzionale. Quando si elimina una directory, il numero di percorsi eliminati con ogni chiamata è limitato. Se il numero di percorsi da eliminare supera questo limite, viene restituito un token di continuazione nell'intestazione della risposta. Quando viene restituito un token di continuazione nella risposta, è necessario specificarlo in una chiamata successiva dell'operazione di eliminazione per continuare a eliminare la directory. |
|
paginated
|
query |
boolean |
Facoltativo e valido solo se lo spazio dei nomi gerarchico è abilitato per l'account e la risorsa è una directory con il parametro di query "ricorsivo" impostato su "true". Per l'eliminazione ricorsiva della directory, il numero di percorsi che possono essere eliminati con ogni chiamata è limitato quando il meccanismo di autorizzazione usato è ACL e il chiamante è un utente non con privilegi avanzati, perché il timeout predefinito è di 30 secondi. Quando il parametro di query "impaginato" è impostato su "true", l'intestazione della risposta può contenere "x-ms-continuation" se viene raggiunto il limite precedente. Durante l'invio del parametro di query "x-ms-continuation" nella richiesta di sottosequnt, il parametro di query "impaginato" e "ricorsivo" deve essere impostato su "true". Quando la risposta non contiene "x-ms-continuation", l'eliminazione ricorsiva della directory ha esito positivo. L'eliminazione effettiva della directory avviene solo nell'ultima chiamata, quelle precedenti comportano controlli ACL nel server dei file e delle directory nella directory da eliminare in modo ricorsivo. |
|
recursive
|
query |
boolean |
Obbligatorio e valido solo quando la risorsa è una directory. Se "true", tutti i percorsi sotto la directory verranno eliminati. Se "false" e la directory non è vuota, si verifica un errore. |
|
timeout
|
query |
integer (int32) minimum: 1 |
Valore facoltativo di timeout dell'operazione in secondi. Il periodo inizia quando la richiesta viene ricevuta dal servizio. Se il valore di timeout è trascorso prima del completamento dell'operazione, l'operazione ha esito negativo. |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
x-ms-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
L'ID lease deve essere specificato se è presente un lease attivo. |
|
If-Match |
string |
Opzionale. Un valore ETag. Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa corrisponde al valore specificato. L'ETag deve essere specificato tra virgolette. |
|
If-None-Match |
string |
Opzionale. Valore ETag o valore con caratteri jolly speciali ("*"). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa non corrisponde al valore specificato. L'ETag deve essere specificato tra virgolette. |
|
If-Modified-Since |
string |
Opzionale. Valore di data e ora. Specificare questa intestazione per eseguire l'operazione solo se la risorsa è stata modificata dopo la data e l'ora specificate. |
|
If-Unmodified-Since |
string |
Opzionale. Valore di data e ora. Specificare questa intestazione per eseguire l'operazione solo se la risorsa non è stata modificata dopo la data e l'ora specificate. |
|
x-ms-client-request-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
UUID registrato nei log di analisi per la risoluzione dei problemi e la correlazione. |
|
x-ms-date |
string |
Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Questa operazione è necessaria quando si usa l'autorizzazione con chiave condivisa. |
|
x-ms-version |
string |
Specifica la versione del protocollo REST usato per l'elaborazione della richiesta. Questa operazione è necessaria quando si usa l'autorizzazione con chiave condivisa. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Il file è stato eliminato. Intestazioni
|
|
202 Accepted |
La richiesta di eliminazione viene accettata, applicabile solo quando lo spazio dei nomi gerarchico è abilitato per l'account. Intestazioni
|
|
Other Status Codes |
Si è verificato un errore. Di seguito sono elencate le possibili stringhe di stato, codice e messaggio HTTP:
Intestazioni
|
Definizioni
Nome | Descrizione |
---|---|
Data |
|
Error |
Oggetto risposta di errore del servizio. |
DataLakeStorageError
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto risposta di errore del servizio. |
Error
Oggetto risposta di errore del servizio.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore del servizio. |
message |
string |
Messaggio di errore del servizio. |