Elimina file

L'operazione Delete File rimuove immediatamente il file dall'account di archiviazione. Questa operazione è supportata nella versione 2025-05-05 e successive per condivisioni file con protocollo NFS abilitato.

Disponibilità del protocollo

Protocollo di condivisione file abilitato	Disponibile
SMB
NFS

Richiesta

La richiesta di Delete File viene costruita nel modo seguente. È consigliabile usare HTTPS.

Metodo	URI della richiesta	Versione HTTP
CANCELLARE	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile	HTTP/1.1

Sostituire i componenti del percorso visualizzati nell'URI della richiesta con i propri, come indicato di seguito:

Componente percorso	Descrizione
myaccount	Nome dell'account di archiviazione.
myshare	Nome della condivisione file.
myparentdirectorypath	Opzionale. Percorso della directory padre.
myfile	Nome del file.

Per informazioni dettagliate sulle restrizioni di denominazione dei percorsi, vedere Denominazione e riferimento a condivisioni, directory, file e metadati.

Parametri URI

È possibile specificare i parametri aggiuntivi seguenti nell'URI della richiesta.

Parametro	Descrizione
timeout	Opzionale. Il parametro di timeout è espresso in secondi. Per altre informazioni, vedere Impostazione dei timeout per le operazioni di File di Azure.

Intestazioni della richiesta

Le intestazioni di richiesta obbligatorie e facoltative sono descritte nelle tabelle seguenti:

Intestazioni di richiesta comuni

Intestazione della richiesta	Descrizione
Authorization	Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Date o x-ms-date	Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
x-ms-version	Obbligatorio per tutte le richieste autorizzate. Specifica la versione dell'operazione da utilizzare per questa richiesta. Questa operazione è supportata nella versione 2025-05-05 e successive per condivisioni file con protocollo NFS abilitato. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
x-ms-lease-id:<ID>	Obbligatorio se il file ha un lease attivo. Disponibile per la versione 2019-02-02 e successive. Questa intestazione viene ignorata se il file si trova in una condivisione file con protocollo NFS abilitato, che non supporta i lease di file.
x-ms-client-request-id	Opzionale. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando viene configurata la registrazione. È consigliabile usare questa intestazione per correlare le attività sul lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare File di Azure.
x-ms-file-request-intent	Obbligatorio se Authorization intestazione specifica un token OAuth. Il valore accettabile è backup. Questa intestazione specifica che il Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action o Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action deve essere concesso se sono inclusi nei criteri di controllo degli accessi in base al ruolo assegnati all'identità autorizzata usando l'intestazione Authorization. Disponibile per la versione 2022-11-02 e successive.
x-ms-allow-trailing-dot: { <Boolean> }	Opzionale. Versione 2022-11-02 e successive. Il valore booleano specifica se un punto finale presente nell'URL della richiesta deve essere tagliato o meno. Questa intestazione viene ignorata se la destinazione si trova in una condivisione file con protocollo NFS abilitato, che supporta il punto finale per impostazione predefinita. Per altre informazioni, vedere Denominazione e riferimento a condivisioni, directory, file e metadati.

Intestazioni di richiesta solo SMB

Nessuno.

Intestazioni di richiesta solo NFS

Nessuno.

Corpo della richiesta

Nessuno.

Risposta

La risposta include un codice di stato HTTP e un set di intestazioni di risposta.

Codice di stato

Un'operazione riuscita restituisce il codice di stato 202 (accettato). Per informazioni sui codici di stato, vedere Stato e codici di errore.

Intestazioni di risposta

La risposta per questa operazione include le intestazioni nelle tabelle seguenti. La risposta può includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1 .

Intestazioni di risposta comuni

Intestazione della risposta	Descrizione
x-ms-request-id	Questa intestazione identifica in modo univoco la richiesta effettuata e può essere usata per la risoluzione dei problemi della richiesta. Per altre informazioni, vedere Risoluzione dei problemi delle operazioni API.
x-ms-version	Indica la versione di File di Azure usata per eseguire la richiesta.
Date	Valore di data/ora UTC che indica l'ora in cui è stata avviata la risposta. Il servizio genera questo valore.
x-ms-client-request-id	È possibile usare questa intestazione per risolvere i problemi relativi alle richieste e alle risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id se presente nella richiesta. Il valore è al massimo 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, questa intestazione non sarà presente nella risposta.

Intestazioni di risposta solo SMB

Nessuno.

Intestazioni di risposta solo NFS

Intestazione della risposta	Descrizione
x-ms-link-count	Versione 2025-05-05 e successive. Nuovo numero di collegamenti del file.

Corpo della risposta

Nessuno.

Autorizzazione

Solo il proprietario dell'account può chiamare questa operazione.

Osservazioni

Quando si elimina correttamente un file, il file viene immediatamente rimosso dall'indice dell'account di archiviazione e non è più accessibile.

Se il file ha un lease attivo, il client deve specificare un ID lease valido nella richiesta per eliminarlo.

Se il file è aperto in un client SMB, Delete File ha esito negativo con il codice di stato 409 (Conflitto) e il codice di errore SharingViolation. Se il file è aperto in un client NFS, Delete File avrà esito positivo e il file verrà eliminato nell'ultima chiusura dell'handle di file aperto.

Delete File non è supportato in uno snapshot di condivisione, ovvero una copia di sola lettura di una condivisione. Se si tenta di eseguire questa operazione su uno snapshot di condivisione, il servizio restituisce l'errore 400 (valore del parametro di query non valido).

Vedere anche

operazioni di su file