Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de changer d’annuaire.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer d’annuaire.
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. Cet article contient la liste des variables d’environnement que vous pouvez utiliser pour configurer AzCopy v10.
Note
Si vous recherchez du contenu pour vous aider à bien démarrer avec AzCopy, consultez Prise en main d’AzCopy.
Variables d’environnement AzCopy v10
Le tableau suivant décrit chaque variable d’environnement et fournit des liens vers du contenu qui peuvent vous aider à utiliser la variable.
| Variable d’environnement | Descriptif |
|---|---|
| AWS_ACCESS_KEY_ID | Clé d’accès Amazon Web Services. Fournit une clé permettant d’autoriser avec Amazon Web Services. Copier des données d’Amazon S3 vers Stockage Azure à l’aide d’AzCopy |
| AWS_SECRET_ACCESS_KEY | La clé d’accès aux secrets Amazon Web Services fournit une clé secrète pour autoriser avec Amazon Web Services. Copier des données d’Amazon S3 vers Stockage Azure à l’aide d’AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Point de terminaison Microsoft Entra à utiliser. Cette variable est utilisée uniquement pour la connexion automatique, utilisez plutôt l’indicateur de ligne de commande lors de l’appel de la commande de connexion. |
| AZCOPY_AUTO_LOGIN_TYPE | Définissez cette variable à DEVICE, MSI, SPN, AZCLI, WORKLOAD, OR PSCRED. Cette variable permet d’autoriser sans utiliser la azcopy login commande. Consultez Autoriser l’accès aux objets blob avec AzCopy et Microsoft Entra ID. |
| AZCOPY_BUFFER_GB | Spécifiez la quantité maximale de mémoire système que vous souhaitez utiliser par AzCopy lors du téléchargement et du chargement de fichiers. Exprimez cette valeur en gigaoctets (Go). Voir Optimiser l’utilisation de la mémoire |
| AZCOPY_CACHE_PROXY_LOOKUP | Par défaut, AzCopy sur Windows met en cache les recherches de serveur proxy au niveau du nom d’hôte (sans prendre en compte le chemin d’URL). Définissez sur n’importe quelle autre valeur que « true » pour désactiver le cache. |
| AZCOPY_CONCURRENCY_VALUE | Spécifie le nombre de requêtes simultanées qui peuvent se produire. Vous pouvez utiliser cette variable pour augmenter le débit. Si votre ordinateur a moins de 5 PROCESSEURs, la valeur de cette variable est définie 32sur . Sinon, la valeur par défaut est égale à 16 multipliée par le nombre de processeurs. La valeur par défaut maximale de cette variable est 3000, mais vous pouvez définir manuellement cette valeur plus ou moins. Voir Augmenter la concurrence |
| AZCOPY_CONCURRENT_FILES | Remplace le nombre (approximatif) de fichiers en cours à tout moment, en contrôlant le nombre de fichiers pour utilisant les transferts simultanés. |
| AZCOPY_CONCURRENT_SCAN | Contrôle le degré de parallélisme (max) utilisé lors de l’analyse. Affecte uniquement les énumérateurs parallélisés, qui incluent Azure Files/Blobs et les systèmes de fichiers locaux. |
| AZCOPY_CONTENT_TYPE_MAP | Remplace un ou plusieurs mappages de types MIME par défaut définis par votre système d’exploitation. Définissez cette variable sur le chemin d’accès d’un fichier JSON qui définit tout mappage. Voici le contenu d’un exemple de fichier JSON : { « MIMETypeMapping » : { .323 » : « text/h323 », .aaf » : « application/octet-stream », .aca » : « application/octet-stream », .accdb » : « application/msaccess » } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Remplace la version de l’API de service afin que AzCopy puisse prendre en charge des environnements personnalisés tels qu’Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | S’applique uniquement lorsque les objets blob Azure sont la source. L’analyse simultanée est plus rapide, mais utilise l’API de référencement hiérarchique, ce qui peut entraîner davantage d’E/S/coût. Spécifiez « true » pour sacrifier les performances, mais économisez sur les coûts. |
| AZCOPY_DISABLE_SYSLOG | Désactive la journalisation dans Syslog ou l’enregistreur d’événements Windows. Par défaut, AzCopy envoie des journaux à ces canaux. Vous pouvez définir cette variable sur true si vous souhaitez réduire le bruit dans Syslog ou dans le journal des événements Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Configure AzCopy pour le télécharger sur un chemin temporaire avant le téléchargement réel. Les valeurs autorisées sont true ou false |
| AZCOPY_JOB_PLAN_LOCATION | Remplace l’emplacement où sont stockés les fichiers de plan de travail (utilisés pour le suivi de la progression et la reprise) afin d’éviter de remplir un disque. |
| AZCOPY_LOG_LOCATION | Remplace l’emplacement de stockage des fichiers journaux pour éviter de remplir un disque. |
| AZCOPY_MSI_CLIENT_ID | ID client d’une identité managée affectée par l’utilisateur. Utilisez quand AZCOPY_AUTO_LOGIN_TYPE est défini sur MSI. Voir Autoriser avec une identité managée affectée par l’utilisateur |
| AZCOPY_MSI_OBJECT_ID | ID d’objet de l’identité managée affectée par l’utilisateur. Utilisez quand AZCOPY_AUTO_LOGIN_TYPE est défini sur MSI. Voir Autoriser avec une identité managée affectée par l’utilisateur |
| AZCOPY_MSI_RESOURCE_STRING | ID de ressource de l’identité managée affectée par l’utilisateur. Voir Autoriser avec une identité managée affectée par l’utilisateur |
| AZCOPY_PACE_PAGE_BLOBS | Le débit des objets blob de pages doit-il être automatiquement ajusté pour correspondre aux limites du service ? La valeur par défaut est true. Défini sur « false » pour désactiver |
| AZCOPY_PARALLEL_STAT_FILES | Provoque la recherche des propriétés de fichier sur des « threads » parallèles lors de l’analyse du système de fichiers local. Les threads sont dessinés à partir du pool défini par AZCOPY_CONCURRENT_SCAN. La définition de cette valeur peut améliorer les performances d’analyse sur Linux. Non nécessaire ou recommandé sur Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Définissez le nombre de minutes pendant lesquelles AzCopy doit essayer de charger des fichiers pour chaque requête avant que AzCopy expire. |
| AZCOPY_SHOW_PERF_STATES | Si elle est définie, sur quoi que ce soit, la sortie à l’écran inclut le nombre de blocs par état |
| AZCOPY_SPA_APPLICATION_ID | ID d’application de l’inscription de l’application de votre principal de service. Utilisez quand AZCOPY_AUTO_LOGIN_TYPE est défini sur SPN. Voir Autoriser un principal de service à l’aide d’une clé secrète client |
| AZCOPY_SPA_CERT_PASSWORD | Mot de passe d’un certificat. Utilisez quand AZCOPY_AUTO_LOGIN_TYPE est défini sur SPN. Voir Autoriser un principal de service à l’aide d’une clé secrète client |
| AZCOPY_SPA_CERT_PATH | Chemin d’accès relatif ou complet à un fichier de certificat. Utilisez quand AZCOPY_AUTO_LOGIN_TYPE est défini sur SPN. Voir Autoriser un principal de service à l’aide d’une clé secrète client |
| AZCOPY_SPA_CLIENT_SECRET | Clé secrète client. Utilisez quand AZCOPY_AUTO_LOGIN_TYPE est défini sur SPN. Voir Autoriser un principal de service à l’aide d’une clé secrète client |
| AZCOPY_TENANT_ID | ID de locataire Microsoft Entra à utiliser pour la connexion interactive de l’appareil OAuth. Cette variable est utilisée uniquement pour la connexion automatique, utilisez plutôt l’indicateur de ligne de commande lors de l’appel de la commande de connexion. |
| AZCOPY_TUNE_TO_CPU | Définissez la valeur false pour empêcher AzCopy de prendre en compte l’utilisation du processeur lors de la mise en forme automatique de son niveau d’accès concurrentiel (par exemple, dans la commande benchmark). |
| AZCOPY_USER_AGENT_PREFIX | Ajoutez un préfixe à l’agent utilisateur AzCopy par défaut, qui est utilisé à des fins de télémétrie. Un espace est automatiquement inséré. |
| CPK_ENCRYPTION_KEY | Valeur de clé de chiffrement AES-256 codée en base64. Cette variable est requise pour les demandes de lecture et d’écriture lors de l’utilisation des clés fournies par le client pour chiffrer et déchiffrer les données sur les opérations de stockage Blob. Vous pouvez utiliser les clés fournies par le client en définissant l’indicateur --cpk-by-value=true . |
| CPK_ENCRYPTION_KEY_SHA256 | Sha256 codé en base64 de la clé de chiffrement. Cette variable est requise pour les demandes de lecture et d’écriture lors de l’utilisation des clés fournies par le client pour chiffrer et déchiffrer les données sur les opérations de stockage Blob. Vous pouvez utiliser les clés fournies par le client en définissant l’indicateur --cpk-by-value=true . |
| GOOGLE_APPLICATION_CREDENTIALS | Le chemin absolu du fichier de clé de compte de service fournit une clé pour autoriser avec Google Cloud Storage. Copier des données de Google Cloud Storage vers Stockage Azure à l’aide d’AzCopy (préversion) |
| GOOGLE_CLOUD_PROJECT | ID de projet requis pour les traversées de niveau de service dans Google Cloud Storage. |
| HTTPS_PROXY | Configure les paramètres de proxy pour AzCopy. Définissez cette variable sur l’adresse IP du proxy et le numéro de port proxy. Par exemple : xx.xxx.xx.xxx:xx. Si vous exécutez AzCopy sur Windows, AzCopy détecte automatiquement les paramètres de proxy. Vous n’êtes donc pas obligé d’utiliser ce paramètre dans Windows. Si vous choisissez d’utiliser ce paramètre dans Windows, il remplace la détection automatique. Consultez Configurer les paramètres du proxy |
Configuration des paramètres de proxy
Pour configurer les paramètres de proxy pour AzCopy, définissez la variable d’environnement HTTPS_PROXY . Si vous exécutez AzCopy sur Windows, AzCopy détecte automatiquement les paramètres de proxy. Vous n’êtes donc pas obligé d’utiliser ce paramètre dans Windows. Si vous choisissez d’utiliser ce paramètre dans Windows, il remplace la détection automatique.
| Système d’exploitation | Command |
|---|---|
| Windows | Dans une invite de commandes, utilisez : set HTTPS_PROXY=<proxy IP>:<proxy port>Dans PowerShell, utilisez : $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
Actuellement, AzCopy ne prend pas en charge les proxys qui nécessitent une authentification avec NTLM ou Kerberos.
Contournement d’un proxy
Si vous exécutez AzCopy sur Windows et que vous souhaitez lui indiquer d’utiliser aucun proxy du tout (au lieu de détecter automatiquement les paramètres) utilisez ces commandes. Avec ces paramètres, AzCopy ne recherche pas ou tente d’utiliser un proxy.
| Système d’exploitation | Environnement | Commands |
|---|---|---|
| Windows | Invite de commandes (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
Sur d’autres systèmes d’exploitation, laissez simplement la variable HTTPS_PROXY non définie si vous souhaitez utiliser aucun proxy.