Introduzione ad AzCopy

AzCopy è un'utilità della riga di comando che è possibile usare per copiare i BLOB o i file da e verso un account di archiviazione. Questo articolo illustra come scaricare AzCopy, connettersi all'account di archiviazione e quindi trasferire i dati.

Nota

AzCopy V10 è la versione attualmente supportata di AzCopy.

Se è necessario usare una versione precedente di AzCopy, vedere la sezione Usare la versione precedente di AzCopy di questo articolo.

Questo video illustra come scaricare ed eseguire l'utilità AzCopy.

I passaggi del video sono descritti anche nelle sezioni seguenti.

Scaricare AzCopy

Prima di tutto, scaricare il file eseguibile azCopy V10 in qualsiasi directory del computer. AzCopy V10 è solo un file eseguibile, quindi non c'è niente da installare.

Questi file vengono compressi come file ZIP (Windows e Mac) o come file tar (Linux). Per scaricare e decomprimere il file tar in Linux, vedere la documentazione per la distribuzione linux.

Per informazioni dettagliate sulle versioni di AzCopy, vedere la pagina relativa alla versione di AzCopy.

Nota

Se si vogliono copiare dati da e verso il servizio di archiviazione tabelle di Azure, installare AzCopy versione 7.3.

Eseguire Azcopy

Per praticità, è consigliabile aggiungere il percorso della directory del file eseguibile di AzCopy al percorso di sistema per facilitarne l'uso. In questo modo è possibile digitare azcopy da qualsiasi directory nel sistema.

Se si sceglie di non aggiungere la directory AzCopy al percorso, sarà necessario modificare le directory nel percorso dell'eseguibile AzCopy e digitare azcopy o .\azcopy nei prompt dei comandi di Windows PowerShell.

In qualità di proprietario dell'account Archiviazione di Azure, non vengono assegnate automaticamente le autorizzazioni per accedere ai dati. Prima di poter eseguire qualsiasi operazione significativa con AzCopy, è necessario decidere come fornire le credenziali di autorizzazione al servizio di archiviazione.

Autorizzare AzCopy

È possibile fornire le credenziali di autorizzazione usando l'ID Microsoft Entra o un token di firma di accesso condiviso.

Opzione 1: Usare Microsoft Entra ID

Usando Microsoft Entra ID, è possibile specificare le credenziali una sola volta invece di dover aggiungere un token di firma di accesso condiviso a ogni comando.

Opzione 2: Usare un token di firma di accesso condiviso

È possibile aggiungere un token di firma di accesso condiviso a ogni URL di origine o di destinazione usato nei comandi di AzCopy.

Questo comando di esempio copia in modo ricorsivo i dati da una directory locale a un contenitore BLOB. Alla fine dell'URL del contenitore viene aggiunto un token di firma di accesso condiviso fittizio.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

Per altre informazioni sui token di firma di accesso condiviso e su come ottenerli, vedere Uso delle firme di accesso condiviso.To learn more about SAS tokens and how to get one, see Using shared access signatures (SAS).

Nota

L'impostazione Trasferimento sicuro richiesto di un account di archiviazione determina se la connessione a un account di archiviazione è protetta con Transport Layer Security (TLS). Questa opzione è attivata per impostazione predefinita.

Trasferire i dati

Dopo aver autorizzato l'identità o ottenuto un token di firma di accesso condiviso, è possibile iniziare a trasferire i dati.

Per trovare comandi di esempio, vedere uno di questi articoli.

Service Articolo
Archiviazione BLOB di Azure Caricare i file in Archiviazione BLOB di Azure
Archiviazione BLOB di Azure Scaricare BLOB da Archiviazione BLOB di Azure
Archiviazione BLOB di Azure Copiare i BLOB tra gli account di archiviazione di Azure
Archiviazione BLOB di Azure Eseguire la sincronizzazione con Archiviazione BLOB di Azure
File di Azure Trasferire dati con AzCopy e l'archivio file
Amazon S3 Copiare dati da Amazon S3 a Archiviazione di Azure
Google Cloud Storage Copiare dati da Google Cloud Archiviazione a Archiviazione di Azure (anteprima)
Archiviazione di Azure Stack Trasferire dati con AzCopy e Archiviazione di Azure Stack

Ottenere la guida per i comandi

Per visualizzare un elenco di comandi, digitare azcopy -h e quindi premere INVIO.

Per informazioni su un comando specifico, è sufficiente includere il nome del comando (ad esempio: azcopy list -h).

Inline help

Elenco dei comandi

Nella tabella seguente sono elencati tutti i comandi azCopy v10. Ogni comando è collegato a un articolo di riferimento.

Comando Descrizione
azcopy bench Esegue un benchmark delle prestazioni caricando o scaricando i dati di test da o verso una posizione specificata.
azcopy copy Copia i dati di origine in un percorso di destinazione
azcopy doc Genera la documentazione per lo strumento in formato Markdown.
azcopy env Mostra le variabili di ambiente che possono configurare il comportamento di AzCopy.
azcopy jobs Sottocomandi correlati alla gestione dei processi.
azcopy jobs clean Rimuovere tutti i file di log e di piano per tutti i processi.
azcopy jobs list Visualizza informazioni su tutti i processi.
azcopy jobs remove Rimuovere tutti i file associati all'ID processo specificato.
azcopy jobs resume Riprende il processo esistente con l'ID processo specificato.
azcopy jobs show Mostra informazioni dettagliate per l'ID processo specificato.
azcopy list Elenca le entità in una determinata risorsa.
azcopy login Accede a Microsoft Entra ID per accedere alle risorse di Archiviazione di Azure.
azcopy login status Elenca le entità in una determinata risorsa.
azcopy logout Disconnette l'utente e termina l'accesso alle risorse di Archiviazione di Azure.
azcopy make Crea un contenitore o una condivisione file.
azcopy remove Eliminare BLOB o file da un account di archiviazione di Azure.
azcopy sync Replica il percorso di origine nella posizione di destinazione.
azcopy set-properties Modificare il livello di accesso di uno o più BLOB e sostituire (sovrascrivere) i metadati e i tag di indice di uno o più BLOB.

Nota

AzCopy non dispone di un comando per rinominare i file.

Usare in uno script

Nel corso del tempo, il collegamento al download di AzCopy punterà alle nuove versioni di AzCopy. Se lo script scarica AzCopy, lo script potrebbe smettere di funzionare se una versione più recente di AzCopy modifica le funzionalità da cui dipende lo script.

Per evitare questi problemi, ottenere un collegamento statico (non modificabile) alla versione corrente di AzCopy. In questo modo, lo script scarica la stessa versione esatta di AzCopy ogni volta che viene eseguita.

Per ottenere il collegamento, eseguire questo comando:

Sistema operativo Comando
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux \| grep ^Location
Windows PowerShell (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue).headers.location
PowerShell 6.1+ (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue -SkipHttpErrorCheck).headers.location

Nota

Per Linux, --strip-components=1 nel tar comando viene rimossa la cartella di primo livello che contiene il nome della versione ed estrae invece il file binario direttamente nella cartella corrente. Ciò consente di aggiornare lo script con una nuova versione di azcopy aggiornando solo l'URL wget .

L'URL viene visualizzato nell'output di questo comando. Lo script può quindi scaricare AzCopy usando tale URL.

Linux

wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1

Windows PowerShell

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\'
$AzCopy = (Get-ChildItem -path '.\' -Recurse -File -Filter 'azcopy.exe').FullName
# Invoke AzCopy 
& $AzCopy

PowerShell 6.1+

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
$AzCopy = (Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\' -PassThru | where-object {$_.Name -eq 'azcopy.exe'}).FullName
# Invoke AzCopy
& $AzCopy

Caratteri speciali di escape nei token di firma di accesso condiviso

Nei file batch con estensione è necessario eseguire l'escape .cmd dei % caratteri visualizzati nei token di firma di accesso condiviso. A tale scopo, aggiungere un carattere aggiuntivo % accanto ai caratteri esistenti % nella stringa del token di firma di accesso condiviso. La sequenza di caratteri risultante viene visualizzata come %%. Assicurarsi di aggiungere un elemento aggiuntivo ^ prima di ogni & carattere per creare la sequenza ^&di caratteri .

Eseguire script con Jenkins

Se si prevede di usare Jenkins per eseguire gli script, assicurarsi di inserire il comando seguente all'inizio dello script.

/usr/bin/keyctl new_session

Usare in Esplora Archiviazione di Azure

Archiviazione Explorer usa AzCopy per eseguire tutte le operazioni di trasferimento dei dati. È possibile usare Archiviazione Explorer se si desidera applicare i vantaggi delle prestazioni di AzCopy, ma si preferisce usare un'interfaccia utente grafica anziché la riga di comando per interagire con i file.

Archiviazione Explorer usa la chiave dell'account per eseguire operazioni, quindi dopo l'accesso a Archiviazione Explorer non è necessario fornire credenziali di autorizzazione aggiuntive.

Configurare, ottimizzare e correggere

Vedere una delle risorse seguenti:

Usare una versione precedente (deprecata)

Se è necessario usare la versione precedente di AzCopy, vedere uno dei collegamenti seguenti:

Nota

Queste versioni di AzCopy sono deprecate. Microsoft consiglia di usare AzCopy v10.

Passaggi successivi

In caso di domande, problemi o commenti generali, inviarli nella pagina di GitHub .