Bien démarrer avec AzCopyGet started with AzCopy

AzCopy est un utilitaire de ligne de commande que vous pouvez utiliser pour copier des blobs ou des fichiers vers ou depuis un compte de stockage.AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. Cet article vous aide à télécharger AzCopy, connectez-vous à votre compte de stockage et transférez des fichiers.This article helps you download AzCopy, connect to your storage account, and then transfer files.

Notes

La version actuellement prise en charge d’AzCopy est la version 10.AzCopy V10 is the currently supported version of AzCopy.

Si vous avez besoin d’utiliser une version antérieure d’AzCopy, consultez la section Utiliser la version précédente d’AzCopy de cet article.If you need to use a previous version of AzCopy, see the Use the previous version of AzCopy section of this article.

Télécharger AzCopyDownload AzCopy

Commencez par télécharger le fichier exécutable AzCopy V10 dans un répertoire sur votre ordinateur.First, download the AzCopy V10 executable file to any directory on your computer. AzCopy v10 est un fichier exécutable, et il n'y a donc rien à installer.AzCopy V10 is just an executable file, so there's nothing to install.

Ces fichiers sont compressés dans un fichier zip (Windows et Mac) ou un fichier tar (Linux).These files are compressed as a zip file (Windows and Mac) or a tar file (Linux). Pour télécharger et décompresser le fichier tar sur Linux, consultez la documentation de votre distribution Linux.To download and decompress the tar file on Linux, see the documentation for your Linux distribution.

Notes

Si vous voulez copier des données depuis et vers le service Table de stockage Azure, installez AzCopy version 7.3.If you want to copy data to and from your Azure Table storage service, then install AzCopy version 7.3.

Exécuter AzCopyRun AzCopy

Pour plus de commodité, vous pouvez envisager d’ajouter l’emplacement du répertoire de l’exécutable AzCopy dans votre chemin d’accès du système.For convenience, consider adding the directory location of the AzCopy executable to your system path for ease of use. De cette façon, vous pouvez saisir azcopy à partir de n’importe quel répertoire sur votre système.That way you can type azcopy from any directory on your system.

Si vous choisissez de ne pas ajouter le répertoire AzCopy à votre chemin d’accès, vous devrez remplacer les répertoires par l’emplacement de votre fichier exécutable AzCopy et saisir azcopy ou .\azcopy dans les invites de commandes Windows PowerShell.If you choose not to add the AzCopy directory to your path, you'll have to change directories to the location of your AzCopy executable and type azcopy or .\azcopy in Windows PowerShell command prompts.

Pour afficher une liste de commandes, saisissez azcopy -h et appuyez sur la touche ENTRÉE.To see a list of commands, type azcopy -h and then press the ENTER key.

Pour en savoir plus sur une commande spécifique, incluez simplement le nom de la commande (par exemple : azcopy list -h).To learn about a specific command, just include the name of the command (For example: azcopy list -h).

Aide en ligneInline help

Pour obtenir une documentation de référence détaillée pour chaque commande et paramètre de commande, consultez azcopyTo find detailed reference documentation for each command and command parameter, see azcopy

Notes

En tant que propriétaire de votre compte de stockage Azure, aucune autorisation d’accès aux données ne vous est automatiquement attribuée.As an owner of your Azure Storage account, you aren't automatically assigned permissions to access data. Avant d’effectuer une opération pertinente avec AzCopy, vous devez choisir comment fournir les informations d’identification d’autorisation du service de stockage.Before you can do anything meaningful with AzCopy, you need to decide how you'll provide authorization credentials to the storage service.

Autoriser AzCopyAuthorize AzCopy

Vous pouvez fournir des informations d’identification d’autorisation à l’aide d’Azure Active Directory (AD), ou en utilisant un jeton de signature d’accès partagé (SAP).You can provide authorization credentials by using Azure Active Directory (AD), or by using a Shared Access Signature (SAS) token.

Utilisez ce tableau pour vous guider :Use this table as a guide:

Type de stockageStorage type Méthode actuellement prise en charge pour l’autorisationCurrently supported method of authorization
Stockage BlobBlob storage Azure AD et SASAzure AD & SAS
Stockage de blobs (espace de noms hiérarchique)Blob storage (hierarchical namespace) Azure AD et SASAzure AD & SAS
Stockage FichierFile storage SAS uniquementSAS only

Option 1 : Utiliser Azure Active DirectoryOption 1: Use Azure Active Directory

Cette option est disponible uniquement pour le stockage blob.This option is available for blob Storage only. En utilisant Azure Active Directory, vous pouvez fournir des informations d’identification en une seule fois au lieu d’ajouter un jeton SAS à chaque commande.By using Azure Active Directory, you can provide credentials once instead of having to append a SAS token to each command.

Notes

Dans la version actuelle, si vous envisagez de copier des blobs entre des comptes de stockage, vous devez ajouter un jeton SAS à chaque URL source.In the current release, if you plan to copy blobs between storage accounts, you'll have to append a SAS token to each source URL. Vous pouvez omettre le jeton SAS uniquement à partir de l’URL de destination.You can omit the SAS token only from the destination URL. Pour des exemples, consultez Copier des objets blob entre des comptes de stockage.For examples, see Copy blobs between storage accounts.

Pour autoriser l’accès à l’aide d’Azure AD, consultez Autoriser l’accès aux objets blob avec AzCopy et Azure Active Directory (Azure AD).To authorize access by using Azure AD, see Authorize access to blobs with AzCopy and Azure Active Directory (Azure AD).

Option n°2 : Utiliser un jeton SASOption 2: Use a SAS token

Vous pouvez ajouter un jeton SAP à chaque URL source ou de destination utilisée dans vos commandes AzCopy.You can append a SAS token to each source or destination URL that use in your AzCopy commands.

Cet exemple de commande copie de manière récursive les données d’un répertoire local dans un conteneur de blobs.This example command recursively copies data from a local directory to a blob container. Un jeton SAP fictif est ajouté à la fin de l’URL du conteneur.A fictitious SAS token is appended to the end of the container URL.

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

Pour en savoir plus sur les jetons SAS et savoir comment en obtenir un, voir Utilisation des signatures d’accès partagé (SAP).To learn more about SAS tokens and how to obtain one, see Using shared access signatures (SAS).

Transfert de donnéesTransfer data

Une fois que vous avez autorisé votre identité ou obtenu un jeton SAP, vous pouvez commencer le transfert des données.After you've authorized your identity or obtained a SAS token, you can begin transferring data.

Pour obtenir des exemples de commandes, consultez l’un de ces articles.To find example commands, see any of these articles.

Utiliser dans un scriptUse in a script

Au fil du temps, le lien de téléchargement AzCopy pointera vers les nouvelles versions d’AzCopy.Over time, the AzCopy download link will point to new versions of AzCopy. Si votre script télécharge AzCopy, il se peut qu’il cesse de fonctionner si une version plus récente d’AzCopy modifie les fonctionnalités dont votre script dépend.If your script downloads AzCopy, the script might stop working if a newer version of AzCopy modifies features that your script depends upon.

Pour éviter ces problèmes, obtenez un lien statique (non modifiable) vers la version actuelle d’AzCopy.To avoid these issues, obtain a static (unchanging) link to the current version of AzCopy. De cette façon, votre script télécharge la même version exacte d’AzCopy à chaque fois qu’il s’exécute.That way, your script downloads the same exact version of AzCopy each time that it runs.

Pour obtenir le lien, exécutez cette commande :To obtain the link, run this command:

Système d’exploitationOperating system CommandeCommand
LinuxLinux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
WindowsWindows (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location

Notes

Pour Linux, --strip-components=1 sur la commande tar supprime le dossier de niveau supérieur qui contient le nom de version, et extrait le binaire directement dans le dossier courant.For Linux, --strip-components=1 on the tar command removes the top-level folder that contains the version name, and instead extracts the binary directly into the current folder. Ceci permet de mettre à jour le script avec une nouvelle version de azcopy en mettant à jour uniquement l’URL wget.This allows the script to be updated with a new version of azcopy by only updating the wget URL.

L’URL apparaît dans la sortie de cette commande.The URL appears in the output of this command. Votre script peut alors télécharger AzCopy en utilisant cette URL.Your script can then download AzCopy by using that URL.

Système d’exploitationOperating system CommandeCommand
LinuxLinux wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1
WindowsWindows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

Caractères spéciaux d’échappement dans les jetons SASEscape special characters in SAS tokens

Dans les fichiers de lot qui portent l’extension .cmd, vous devez placer dans une séquence d’échappement les caractères % qui apparaissent dans les jetons SAS.In batch files that have the .cmd extension, you'll have to escape the % characters that appear in SAS tokens. Pour cela, ajoutez un caractère % supplémentaire à côté des caractères % existants dans la chaîne de jeton SAS.You can do that by adding an additional % character next to existing % characters in the SAS token string.

Exécuter des scripts à l’aide de JenkinsRun scripts by using Jenkins

Si vous envisagez d’utiliser Jenkins pour exécuter des scripts, veillez à placer la commande suivante au début du script.If you plan to use Jenkins to run scripts, make sure to place the following command at the beginning of the script.

/usr/bin/keyctl new_session

Utiliser dans l'Explorateur Stockage AzureUse in Azure Storage Explorer

L’Explorateur de stockage utilise AzCopy pour effectuer toutes les opérations de transfert de données.Storage Explorer uses AzCopy to perform all of its data transfer operations. Vous pouvez utiliser l’Explorateur Stockage Azure si vous souhaitez tirer parti des avantages d’AzCopy en termes de performances, mais préférez utiliser l’interface graphique utilisateur plutôt que la ligne de commande pour interagir avec vos fichiers.You can use Storage Explorer if you want to leverage the performance advantages of AzCopy, but you prefer to use a graphical user interface rather than the command line to interact with your files.

L’Explorateur Stockage utilise votre clé de compte pour effectuer des opérations, donc après vous être connecté à Storage Explorer, vous n’aurez pas besoin de fournir des informations d’autorisation supplémentaires.Storage Explorer uses your account key to perform operations, so after you sign into Storage Explorer, you won't need to provide additional authorization credentials.

Configurer, optimiser et corrigerConfigure, optimize, and fix

Voir Configurer, optimiser et dépanner AzCopySee Configure, optimize, and troubleshoot AzCopy

Utiliser une version précédenteUse a previous version

Si vous devez utiliser la version précédente d’AzCopy, consultez l’un des liens suivants :If you need to use the previous version of AzCopy, see either of the following links:

Étapes suivantesNext steps

Si vous avez des questions, des problèmes ou des commentaires d’ordre général, saisissez-les sur la page GitHub.If you have questions, issues, or general feedback, submit them on GitHub page.