Copia file
L'operazione Copy File copia un BLOB o un file in un file di destinazione all'interno dell'account di archiviazione. 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 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 |
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 i parametri aggiuntivi seguenti nell'URI della richiesta:
| Parametro | Descrizione |
|---|---|
timeout |
Opzionale. Il parametro timeout è espresso in secondi. Per altre informazioni, vedere Impostare i 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-meta-name:value |
Opzionale. Specifica le coppie nome/valore associate al file come metadati. Se non vengono specificate coppie nome/valore, l'operazione copia i metadati dal BLOB di origine o dal file di destinazione. Se vengono specificate una o più coppie nome/valore, il file di destinazione viene creato con i metadati specificati e i metadati non vengono copiati dal BLOB o dal file di origine. I nomi dei metadati devono rispettare le regole di denominazione per gli identificatori C# . I metadati dei file specificati tramite File di Azure non sono accessibili da un client SMB. |
x-ms-copy-source:name |
Obbligatorio. Specifica l'URL del file di origine o del BLOB, con una lunghezza massima di 2 kibibyte (KiB). Per copiare un file in un altro file all'interno dello stesso account di archiviazione, è possibile usare una chiave condivisa per autorizzare il file di origine. Se si copia un file da un altro account di archiviazione o se si copia un BLOB dallo stesso account di archiviazione o da un altro account di archiviazione, è necessario autorizzare il file o il BLOB di origine usando una firma di accesso condiviso. Se l'origine è un BLOB pubblico, non è necessaria alcuna autorizzazione per eseguire l'operazione di copia. È anche possibile specificare un file in uno snapshot di condivisione come origine di copia. Ecco alcuni esempi di URL di oggetti di origine:
|
x-ms-lease-id:<ID> |
Obbligatorio se il file di destinazione ha un lease attivo. Disponibile per la versione 2019-02-02 e successive. L'ID lease specificato per questa intestazione deve corrispondere all'ID lease del file di destinazione. Se la richiesta non include l'ID lease o l'ID non è valido, l'operazione non riesce con il codice di stato 412 (Precondizione non riuscita). Se questa intestazione è specificata e il file di destinazione non ha attualmente un lease attivo, l'operazione non riesce con il codice di stato 412 (precondizione non riuscita). 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-file-creation-time |
Opzionale. Disponibile per la versione 2019-07-07 e successive. Questa intestazione specifica la proprietà per l'ora di creazione, in formato UTC, da impostare nel file di destinazione. È possibile usare un valore di source per copiare l'ora di creazione dal file di origine al file di destinazione. |
x-ms-file-last-write-time |
Opzionale. Disponibile per la versione 2019-07-07 e successive. Questa intestazione specifica la proprietà per l'ora dell'ultima scrittura, in formato UTC, da impostare nel file di destinazione. È possibile usare un valore di source per copiare l'ora dell'ultima scrittura dal file di origine al file di destinazione. |
x-ms-client-request-id |
Opzionale. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 KiB registrato nei log durante la configurazione della registrazione. È consigliabile usare questa intestazione per correlare le attività sul lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare l'archiviazione BLOB 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. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Opzionale. Versione 2022-11-02 e successive. Il valore booleano specifica se un punto finale presente nell'URL di origine deve essere tagliato o meno. Questa intestazione deve essere specificata solo se l'origine di copia si trova in una condivisione file di Azure. Questa intestazione non è supportata per altri tipi di origine di copia. Questa intestazione viene ignorata se l'origine della copia 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
| Intestazione della richiesta | Descrizione |
|---|---|
x-ms-file-change-time: { <DateTime> ¦ source } |
Opzionale. Versione 2021-06-08 e successive. Proprietà dell'ora di modifica UTC per il file, formattata nel formato ISO 8601. È possibile usare un valore di source per copiare l'ora di modifica dal file di origine al file di destinazione. Il timestamp predefinito è l'ora della richiesta. |
x-ms-file-permission-copy-mode: { source ¦ override } |
Opzionale. Disponibile per la versione 2019-07-07 e successive. Determina il comportamento di copia del descrittore di sicurezza del file:
|
x-ms-file-permission: { <SDDL> ¦ <binary> } |
Obbligatorio se x-ms-file-permission-copy-mode viene specificato come override e x-ms-file-permission-key non viene specificato. Disponibile per la versione 2019-07-07 e successive. Questa autorizzazione è il descrittore di sicurezza per il file specificato nel Security Descriptor Definition Language (SDDL) o (versione 2025-01-05 o successiva) in formato descrittore di sicurezza binario con codifica base64 formato descrittore di sicurezza binario. È possibile specificare il formato da usare con l'intestazione x-ms-file-permission-format. È possibile usare questa intestazione se le dimensioni delle autorizzazioni sono di 8 kibibyte (KiB) o meno. In caso contrario, è possibile usare x-ms-file-permission-key. Se specificato, deve avere un proprietario, un gruppo e elenco di controllo di accesso discrezionale (DACL). È possibile specificare solo uno dei x-ms-file-permission o x-ms-file-permission-key. |
x-ms-file-permission-key |
Obbligatorio se x-ms-file-permission-copy-mode viene specificato come override e x-ms-file-permission non è specificato. Disponibile per la versione 2019-07-07 e successive. Questa intestazione specifica la chiave dell'autorizzazione da impostare per il file. È possibile creare questa chiave usando l'operazione di Create Permission.È possibile specificare solo uno dei x-ms-file-permission o x-ms-file-permission-key. |
x-ms-file-permission-format: { sddl ¦ binary } |
Opzionale. Versione 2025-01-05 o successiva. Specifica se il valore passato in x-ms-file-permission è in FORMATO SDDL o binario. Se questa intestazione non è impostata, viene usato il valore predefinito di sddl. |
x-ms-file-attributes |
Opzionale. Disponibile per la versione 2019-07-07 e successive. Questa intestazione specifica gli attributi del file system da impostare nel file di destinazione. Vedere l'elenco degli attributi disponibili . È possibile usare un valore di source per copiare gli attributi dal file di origine al file di destinazione. È possibile usare un valore di none per cancellare tutti gli attributi nel file di destinazione. |
x-ms-file-copy-ignore-readonly |
Opzionale. Disponibile per la versione 2019-07-07 e successive. Questo valore booleano specifica se l'attributo ReadOnly in un file di destinazione preesistente deve essere rispettato. Se è true, l'operazione di copia ha esito positivo. In caso contrario, un file precedente nella destinazione con il set di attributi ReadOnly causa l'esito negativo dell'operazione di copia. |
x-ms-file-copy-set-archive |
Opzionale. Disponibile per la versione 2019-07-07 e successive. Questo valore booleano specifica se l'attributo Archive deve essere impostato, indipendentemente dal valore dell'intestazione x-ms-file-attributes. |
Intestazioni di richiesta solo NFS
| Intestazione della richiesta | Descrizione |
|---|---|
x-ms-file-mode-copy-mode: { source ¦ override } |
Opzionale. Versione 2025-05-05 e successive. Applicabile solo quando l'origine di copia è un file che si trova in una condivisione file con protocollo NFS abilitato. Determina il comportamento di copia dei bit in modalità del file:
|
x-ms-mode |
Versione 2025-05-05 e successive. Obbligatorio se x-ms-file-mode-copy-mode viene specificato come override. Bit di modalità da impostare nel file. La modalità è rappresentata nel formato ottale numerico a 12 bit o nel formato simbolico 'rwx'. Vedere le autorizzazioni dei file POSIX (modalità). |
x-ms-file-owner-copy-mode: { source ¦ override } |
Opzionale. Versione 2025-05-05 e successive. Applicabile solo quando l'origine di copia è un file che si trova in una condivisione file con protocollo NFS abilitato. Determina il comportamento di copia dell'identificatore utente proprietario (UID) e dell'identificatore di gruppo (GID) del file:
|
x-ms-owner |
Versione 2025-05-05 e successive. Identificatore utente (UID) del proprietario del file da impostare nel file. Obbligatorio se x-ms-file-owner-copy-mode viene specificato come override. |
x-ms-group |
Versione 2025-05-05 e successive. Identificatore di gruppo (GID) del proprietario del file da impostare nel file. Obbligatorio se x-ms-file-owner-copy-mode viene specificato come override. |
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 |
|---|---|
ETag |
Se l'operazione di copia viene completata, contiene il valore ETag del file di destinazione. Se l'operazione di copia non è stata completata, contiene il valore ETag del file vuoto creato all'inizio dell'operazione. |
Last-Modified |
Restituisce la data/ora in cui è stata completata l'operazione di copia nel file di destinazione. |
x-ms-request-id |
Identifica in modo univoco la richiesta effettuata. È possibile usare questa intestazione per risolvere i problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle 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 il servizio ha inviato la risposta. |
x-ms-copy-id: <id> |
Fornisce un identificatore di stringa per questa operazione di copia. Usare con Get File o Get File Properties per controllare lo stato di questa operazione di copia o passare a Abort Copy File per annullare un'operazione di copia in sospeso. |
x-ms-copy-status: <success ¦ pending> |
Indica lo stato dell'operazione di copia con questi valori: - success: operazione di copia completata correttamente.- pending: l'operazione di copia è ancora in corso. |
x-ms-client-request-id |
Può essere usato 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 e 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
Nessuno.
Corpo della risposta
Nessuno
Risposta di esempio
Response Status:
HTTP/1.1 202 Accepted
Response Headers:
Last-Modified: <date>
ETag: "0x8CEB669D794AFE2"
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402
x-ms-version: 2015-02-21
x-ms-copy-id: 1f812371-a41d-49e6-b123-f4b542e851c5
x-ms-copy-status: pending
Date: <date>
Autorizzazione
Questa operazione può essere chiamata dal proprietario dell'account o da un client che dispone di una firma di accesso condiviso che dispone dell'autorizzazione per la scrittura nel file di destinazione o nella relativa condivisione. Si noti che la firma di accesso condiviso specificata nella richiesta si applica solo al file di destinazione.
L'accesso al file di origine o al BLOB è autorizzato separatamente, come descritto nei dettagli per l'intestazione della richiesta x-ms-copy-source.
Nella tabella seguente viene descritto il modo in cui è possibile autorizzare gli oggetti di destinazione e di origine per un'operazione di Copy File:
| File | Autorizzazione con chiave condivisa o chiave condivisa Lite | Autorizzazione con firma di accesso condiviso | Oggetto pubblico che non richiede l'autorizzazione |
|---|---|---|---|
| File di destinazione | Sì | Sì | Non applicabile |
| File di origine nello stesso account | Sì | Sì | Non applicabile |
| File di origine in un altro account | No | Sì | Non applicabile |
| BLOB di origine nello stesso account o in un altro account | No | Sì | Sì |
Attributi del file system
| Attributo | Attributo del file Win32 | Definizione |
|---|---|---|
ReadOnly |
FILE_ATTRIBUTE_READONLY |
Il file è di sola lettura. Le applicazioni possono leggere il file, ma non possono scriverlo o eliminarlo. |
Hidden |
FILE_ATTRIBUTE_HIDDEN |
Il file è nascosto. Non è incluso in un elenco di directory normale. |
System |
FILE_ATTRIBUTE_SYSTEM |
Il sistema operativo usa una parte del file oppure usa esclusivamente il file. |
None |
FILE_ATTRIBUTE_NORMAL |
Il file non ha altri attributi impostati. Questo attributo è valido solo quando viene usato da solo. |
Archive |
FILE_ATTRIBUTE_ARCHIVE |
Il file è un file di archivio. Le applicazioni usano in genere questo attributo per contrassegnare i file per il backup o la rimozione. |
Temporary |
FILE_ATTRIBUTE_TEMPORARY |
Il file viene usato per l'archiviazione temporanea. |
Offline |
FILE_ATTRIBUTE_OFFLINE |
I dati del file non sono immediatamente disponibili. Questo attributo del file system offre principalmente la compatibilità con Windows. File di Azure non lo supporta con le opzioni di archiviazione offline. |
NotContentIndexed |
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED |
Il servizio di indicizzazione del contenuto non indicizza il file. |
NoScrubData |
FILE_ATTRIBUTE_NO_SCRUB_DATA |
Lo scanner di integrità dei dati in background non leggerà il flusso di dati utente. Questo attributo del file system offre principalmente la compatibilità con Windows. |
Autorizzazioni per i file POSIX (modalità)
Le autorizzazioni per i file POSIX possono essere specificate numericamente in un formato ottale numerico a 12 bit o in un formato simbolico "rwx". Esempi:
- "0644" o "rw-r--r--": l'utente (proprietario del file) dispone dell'autorizzazione di lettura e scrittura. Il gruppo dispone dell'autorizzazione di lettura. Altri utenti dispongono dell'autorizzazione di lettura.
- "0755" o "rwxr-xr-x": l'utente (proprietario del file) dispone dell'autorizzazione di lettura, scrittura ed esecuzione. Il gruppo dispone dell'autorizzazione di lettura ed esecuzione. Altri utenti dispongono dell'autorizzazione di lettura ed esecuzione.
Formato ottale numerico
I tre numeri ottali più bassi rappresentano le autorizzazioni per proprietario/utente, gruppo e altri e vengono indicati usando un numero ottale (0-7), formato usando una combinazione bit per bit di '4' (lettura), '2' (scrittura), '1' (esecuzione). Il numero ottale più alto (0-7) viene usato per indicare una combinazione di autorizzazioni '4' (SetUID), '2' (SetGID), '1' (StickyBit).
| Formato | Permesso |
|---|---|
| 0700 | L'utente (proprietario del file) dispone dell'autorizzazione lettura, scrittura ed esecuzione. |
| 0400 | L'utente dispone dell'autorizzazione di lettura. |
| 0200 | L'utente dispone dell'autorizzazione di scrittura. |
| 0100 | L'utente dispone dell'autorizzazione di esecuzione. |
| 0070 | Il gruppo dispone dell'autorizzazione lettura, scrittura ed esecuzione. |
| 0040 | Il gruppo dispone dell'autorizzazione di lettura. |
| 0020 | Il gruppo dispone dell'autorizzazione di scrittura. |
| 0010 | Il gruppo dispone dell'autorizzazione di esecuzione. |
| 0007 | Altri hanno autorizzazioni di lettura, scrittura ed esecuzione. |
| 0004 | Altri utenti dispongono dell'autorizzazione di lettura. |
| 0002 | Altri dispongono dell'autorizzazione di scrittura. |
| 0001 | Altri utenti dispongono dell'autorizzazione di esecuzione. |
| 4000 | Impostare l'ID utente effettivo nel file. |
| 2000 | Impostare l'ID gruppo effettivo nel file. |
| 1000 | Impostare per indicare che il file può essere eliminato o rinominato solo dal proprietario del file, dal proprietario della directory o dall'utente radice. |
Formato simbolico "rwx"
Le autorizzazioni per proprietario/utente, gruppo e altre sono indicate usando una combinazione di caratteri 'r' (lettura), 'w' (scrittura) e 'x' (Esegui).
| Formato | Permesso |
|---|---|
| rwx------ | L'utente (proprietario del file) dispone dell'autorizzazione di lettura, scrittura ed esecuzione. |
| r-------- | L'utente dispone dell'autorizzazione di lettura. |
| -w------- | L'utente dispone dell'autorizzazione di scrittura. |
| --x------ | L'utente dispone dell'autorizzazione di esecuzione. |
| ---rwx--- | Il gruppo dispone dell'autorizzazione di lettura, scrittura ed esecuzione. |
| ---r----- | Il gruppo dispone dell'autorizzazione di lettura. |
| ----w---- | Il gruppo dispone dell'autorizzazione di scrittura. |
| -----x--- | Il gruppo dispone dell'autorizzazione di esecuzione. |
| ------rwx | Altri hanno autorizzazioni di lettura, scrittura ed esecuzione. |
| ------r- | Altri utenti dispongono dell'autorizzazione di lettura. |
| -------w- | Altri dispongono dell'autorizzazione di scrittura. |
| --------x | Altri utenti dispongono dell'autorizzazione di esecuzione. |
Osservazioni
L'operazione Copy File può terminare in modo asincrono. È possibile usare l'ID copia restituito dall'intestazione di risposta x-ms-copy-id per controllare lo stato dell'operazione di copia o per annullarlo. File di Azure copia i file in modo ottimale.
Se il file di destinazione esiste, viene sovrascritto. Non è possibile modificare il file di destinazione mentre l'operazione di copia è in corso.
L'operazione Copy File copia sempre l'intero BLOB o file di origine. La copia di un intervallo di byte o di un set di blocchi non è supportata.
L'origine di un'operazione di Copy File può essere un file che risiede in uno snapshot di condivisione. La destinazione di un'operazione di Copy File non può essere un file che risiede in uno snapshot di condivisione.
Quando l'origine di un'operazione di copia fornisce valori ETag, se sono presenti modifiche all'origine mentre l'operazione è in corso, l'operazione ha esito negativo. Un tentativo di modificare il file di destinazione mentre è in corso un'operazione di copia non riesce con codice di stato 409 (conflitto).
Il valore ETag per il file di destinazione viene modificato all'avvio dell'operazione di Copy File. Continua a cambiare frequentemente durante l'operazione di copia.
Copia di proprietà e metadati
Quando un BLOB o un file viene copiato, le proprietà di sistema seguenti vengono copiate nel file di destinazione con gli stessi valori:
Content-TypeContent-EncodingContent-LanguageContent-LengthCache-ControlContent-MD5Content-Disposition
Il file di destinazione ha sempre le stesse dimensioni del BLOB o del file di origine. Il valore dell'intestazione Content-Length per il file di destinazione corrisponde al valore di tale intestazione per il BLOB o il file di origine.
Copia di un BLOB o di un file in lease in un file
L'operazione Copy File legge solo dal BLOB o dal file di origine, quindi un lease sull'oggetto di origine non influisce sull'operazione. L'operazione Copy File salva il valore ETag del BLOB o del file di origine all'avvio dell'operazione. Se il valore ETag viene modificato prima del completamento dell'operazione di copia, l'operazione ha esito negativo. È possibile impedire modifiche al BLOB di origine del file tramite leasing durante l'operazione di copia.
Se il file di destinazione ha un lease infinito attivo, è necessario specificarne l'ID lease nella chiamata all'operazione di Copy File. Mentre l'operazione di copia è in sospeso, qualsiasi operazione di lease nel file di destinazione ha esito negativo con codice di stato 409 (conflitto). Un lease infinito nel file di destinazione viene bloccato in questo modo durante l'operazione di copia, indipendentemente dal fatto che si stia copiando in un file di destinazione con un nome diverso dall'origine o copiandolo in un file di destinazione con lo stesso nome dell'origine. Se il client specifica un ID lease in un file che non esiste ancora, File di Azure restituisce il codice di stato 412 (Precondizione non riuscita).
Utilizzo di un'operazione di copia in sospeso
L'operazione Copy File potrebbe terminare la copia dei file in modo asincrono. Usare la tabella seguente per determinare il passaggio successivo in base al codice di stato restituito Copy File:
| Codice di stato | Significato |
|---|---|
| 202 (accettato), x-ms-copy-status: operazione riuscita | Operazione di copia completata. |
| 202 (accettato), x-ms-copy-status: in sospeso | Operazione di copia non completata. Eseguire il polling del BLOB di destinazione usando Get File Properties per esaminare x-ms-copy-status fino al termine o all'esito negativo dell'operazione di copia. |
| 4xx, 500 o 503 | Operazione di copia non riuscita. |
Durante e dopo un'operazione di Copy File, le proprietà del file di destinazione contengono l'ID copia dell'operazione di Copy File e l'URL del BLOB o del file di origine. Al termine dell'operazione, File di Azure scrive il valore di ora e risultato (success, failedo aborted) nelle proprietà del file di destinazione. Se l'operazione ha un risultato failed, l'intestazione x-ms-copy-status-description contiene una stringa di dettaglio dell'errore.
Un'operazione di Copy File in sospeso ha un timeout di due settimane. Tentativo di copia che non è stato completato dopo due settimane di timeout e lascia un file vuoto con il campo x-ms-copy-status impostato su failed e il campo x-ms-status-description impostato su 500 (OperationCancelled). Errori intermittenti e non irreversibili che possono verificarsi durante un'operazione di copia potrebbero impedire lo stato di avanzamento dell'operazione, ma non causarne l'esito negativo. In questi casi, x-ms-copy-status-description descrive gli errori intermittenti.
Qualsiasi tentativo di modificare il file di destinazione durante l'operazione di copia non riesce con codice di stato 409 (conflitto), "Copia file in corso".
Se si chiama un'operazione di Abort Copy File, verrà visualizzata un'intestazione x-ms-copy-status:aborted. Il file di destinazione avrà metadati intatti e una lunghezza di file di 0 byte. È possibile ripetere la chiamata originale a Copy File per ritentare l'operazione.
Fatturazione
L'account di destinazione di un'operazione di Copy File viene addebitato per l'avvio dell'operazione da parte di una transazione. L'account di destinazione comporta anche una transazione per ogni richiesta per annullare o richiedere lo stato dell'operazione di copia.
Quando il file di origine o il BLOB si trova in un altro account, l'account di origine comporta costi delle transazioni. Inoltre, se gli account di origine e di destinazione si trovano in aree diverse (ad esempio Stati Uniti settentrionali e Stati Uniti meridionali), la larghezza di banda usata per trasferire la richiesta viene addebitata all'account di origine come uscita. L'uscita tra account all'interno della stessa area è gratuita.
Vedere anche
- operazioni di su file
- Autorizzare le richieste ad Archiviazione di Azure
- codici di errore e stato
- codici di errore di File di Azure
- interrompere file di copia