Interrompi copia file

L'operazione Abort Copy File annulla un'operazione di Copy File in sospeso e lascia un file di destinazione con lunghezza zero e metadati completi. Questa operazione è supportata nella versione 2015-02-21 e successive per condivisioni file con protocollo SMB abilitato e 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 Abort Copy File viene costruita nel modo seguente. È consigliabile usare HTTPS.

A partire dalla versione 2013-08-15, è possibile specificare una firma di accesso condiviso per il file di destinazione se si trova nello stesso account del file di origine. A partire dalla versione 2015-04-05, è anche possibile specificare una firma di accesso condiviso per il file di destinazione se si trova in un account di archiviazione diverso.

Metodo	URI della richiesta	Versione HTTP
METTERE	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy&copyid=<id>	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.
mydirectorypath	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 il parametro aggiuntivo seguente 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 2015-02-21 e successive per condivisioni file con protocollo SMB abilitato e 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-copy-action:abort	Obbligatorio.
x-ms-lease-id:<ID>	Obbligatorio se il file di destinazione ha un lease attivo. Disponibile per le versioni 2019-02-02 e successive. Questa intestazione viene ignorata se il file di destinazione 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 204 (Nessun contenuto). 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.
x-ms-version	Indica la versione di File di Azure usata per eseguire la richiesta.
Date o x-ms-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 1024 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

Nessuno.

Corpo della risposta

Nessuno.

Autorizzazione

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

Osservazioni

Quando si annulla un'operazione di Copy File in sospeso, l'intestazione x-ms-copy-status del file di destinazione viene impostata su aborted. L'annullamento di un'operazione di copia comporta un file di destinazione di lunghezza zero. Tuttavia, i metadati per il file di destinazione avranno i nuovi valori copiati dal BLOB o dal file di origine oppure impostati in modo esplicito nella chiamata all'operazione Copy File.

È possibile annullare solo un'operazione di copia in sospeso. Il tentativo di annullare una copia completata o non riuscita genera un errore di conflitto. Il tentativo di annullare un'operazione di copia usando un ID di copia non corretto genera anche un errore di conflitto.

Vedere anche

operazioni sui file