Paramètres de configuration d’AzCopy v10 (Stockage Azure)
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 une liste de variables d’environnement que vous pouvez utiliser pour configurer AzCopy v10.
Notes
Si vous recherchez du contenu pour vous aider à bien démarrer avec AzCopy, consultez Bien démarrer avec AzCopy.
Variables d’environnement d’AzCopy v10
Le tableau suivant décrit chaque variable d’environnement et fournit des liens vers du contenu qui peut vous aider à utiliser la variable.
| Variable d’environnement | Description |
|---|---|
| AWS_ACCESS_KEY_ID | Clé d’accès d’Amazon Web Services. Fournit une clé pour autoriser l’utilisation avec Amazon Web Services. Copier des données d’Amazon S3 vers Stockage Azure Storage en utilisant AzCopy |
| AWS_SECRET_ACCESS_KEY | Clé d’accès secrète d’Amazon Web Services. Fournit une clé secrète pour autoriser l’utilisation avec Amazon Web Services. Copier des données depuis Amazon S3 vers le Stockage Azure avec AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Le point de terminaison Microsoft Entra à utiliser. Cette variable est utilisée seulement 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 sur DEVICE, , MSISPN, AZCLIet PSCRED. Cette variable permet d’autoriser sans utiliser la commande azcopy login. 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 qu’AzCopy doit utiliser lors du téléchargement et du chargement de fichiers. Exprimez cette valeur en gigaoctets (Go). Consultez Optimiser l’utilisation de la mémoire |
| AZCOPY_CACHE_PROXY_LOOKUP | Par défaut, AzCopy sur Windows met en cache les recherches du serveur proxy au niveau du nom d’hôte (ne prend pas en compte le chemin d’URL). Définissez sur une valeur autre que « true » pour désactiver le cache. |
| AZCOPY_CONCURRENCY_VALUE | Cette variable spécifie le nombre de demandes pouvant être effectuées simultanément. Vous pouvez utiliser cette variable pour augmenter le débit. Si votre ordinateur dispose de moins de 5 unités centrales, la valeur de cette variable est définie sur 32. Sinon, la valeur par défaut est égale à 16 multiplié par le nombre d’unités centrales. La valeur maximale par défaut de cette variable est 3000, mais vous pouvez l’augmenter ou la diminuer manuellement. Consultez Augmenter les accès concurrentiels |
| AZCOPY_CONCURRENT_FILES | Remplace le nombre (approximatif) de fichiers en cours à un moment donné, en contrôlant le nombre de fichiers pour lesquels nous lançons des transferts simultanément. |
| AZCOPY_CONCURRENT_SCAN | Contrôle le degré (maximal) de parallélisme utilisé lors de l’analyse. Affecte seulement les énumérateurs parallélisés, qui incluent Azure Files/Objets blob Azure et des 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’un fichier JSON qui définit un 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 pour qu’AzCopy puisse prendre en charge des environnements personnalisés comme Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | S’applique seulement quand Stockage Blob Azure est la source. L’analyse simultanée est plus rapide mais utilise l’API de liste hiérarchique, ce qui peut entraîner un coût plus élevé en matière d’E/S. Spécifiez « true » pour sacrifier les performances au profit du coût. |
| AZCOPY_DISABLE_SYSLOG | Désactive la journalisation dans Syslog ou le journal des événements Windows. Par défaut, AzCopy envoie les 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 d’accès temporaire avant le téléchargement réel. Les valeurs autorisées sont true ou false |
| AZCOPY_JOB_PLAN_LOCATION | Remplace l’emplacement de stockage des fichiers du plan de travail (utilisés pour le suivi de l’avancement et la reprise) pour éviter de saturer un disque. |
| AZCOPY_LOG_LOCATION | Remplace l’emplacement de stockage des fichiers journaux pour éviter de saturer un disque. |
| AZCOPY_MSI_CLIENT_ID | ID de client d’une identité managée affectée par l’utilisateur. Utilisez cela quand AZCOPY_AUTO_LOGIN_TYPE est défini sur MSI. Consultez Autoriser sans magasin de secrets. |
| AZCOPY_MSI_OBJECT_ID | ID d’objet de l’identité managée affectée par l’utilisateur. Utilisez cela quand AZCOPY_AUTO_LOGIN_TYPE est défini sur MSI. Consultez Autoriser sans magasin de secrets. |
| AZCOPY_MSI_RESOURCE_STRING | ID de ressource de l’identité managée affectée par l’utilisateur. Consultez Autoriser sans magasin de secrets. |
| AZCOPY_PACE_PAGE_BLOBS | Le débit des objets blob de pages doit-il être ajusté automatiquement pour correspondre aux limites du service ? La valeur par défaut est true. Définissez sur « false » pour désactiver |
| AZCOPY_PARALLEL_STAT_FILES | Fait qu’AzCopy recherche les propriétés des fichiers sur des « threads » parallèles lors de l’analyse du système de fichiers local. Les threads sont tirés du pool défini par AZCOPY_CONCURRENT_SCAN. Définir ceci sur true peut améliorer les performances de l’analyse sur Linux. Non nécessaire ni recommandé sur Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Définit le nombre de minutes pendant lesquelles AzCopy doit essayer de charger des fichiers de chaque requête avant l’expiration d’AzCopy. |
| AZCOPY_SHOW_PERF_STATES | Si cette valeur est définie, la sortie à l’écran inclut le nombre de blocs par état. |
| AZCOPY_SPA_APPLICATION_ID | ID d’application de l’inscription d’application du principal de service. Utilisez cela quand AZCOPY_AUTO_LOGIN_TYPE est défini sur SPN. Consultez Autoriser sans magasin de secrets. |
| AZCOPY_SPA_CERT_PASSWORD | Mot de passe d’un certificat. Utilisez cela quand AZCOPY_AUTO_LOGIN_TYPE est défini sur SPN. Consultez Autoriser sans magasin de secrets. |
| AZCOPY_SPA_CERT_PATH | Chemin relatif ou complet d’un fichier de certificat. Utilisez cela quand AZCOPY_AUTO_LOGIN_TYPE est défini sur SPN. Consultez Autoriser sans magasin de secrets. |
| AZCOPY_SPA_CLIENT_SECRET | Secret client. Utilisez cela quand AZCOPY_AUTO_LOGIN_TYPE est défini sur SPN. Consultez Autoriser sans magasin de secrets. |
| AZCOPY_TENANT_ID | L’ID de locataire Microsoft Entra à utiliser pour la connexion interactive de l’appareil OAuth. Cette variable est utilisée seulement 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 sur false pour empêcher AzCopy de prendre en compte l’utilisation du processeur lors de l’optimisation 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 d’AzCopy par défaut, qui est utilisé à des fins de télémétrie. Un espace est inséré automatiquement. |
| CPK_ENCRYPTION_KEY | Valeur de clé de chiffrement AES-256 encodée en base64. Cette variable est requise pour les demandes de lecture et d’écriture lors de l’utilisation de clés fournies par le client pour chiffrer et déchiffrer des 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 | Valeur SHA256 encodée en base64 de la clé de chiffrement. Cette variable est requise pour les demandes de lecture et d’écriture lors de l’utilisation de clés fournies par le client pour chiffrer et déchiffrer des 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 au fichier de clés du compte de service. Fournit une clé pour autoriser l’utilisation de Google Cloud Storage. Copier les 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 du 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’avez donc pas besoin 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 de 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’avez donc pas besoin 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 | Commande |
|---|---|
| Windows | Dans une invite de commandes, tapez : set HTTPS_PROXY=<proxy IP>:<proxy port>Pour PowerShell, tapez : $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 en charge les serveurs proxy qui requièrent une authentification avec NTLM ou Kerberos.
Contournement d’un proxy
Si vous exécutez AzCopy sur Windows et souhaitez lui demander de n’utiliser aucun proxy (au lieu de détecter automatiquement les paramètres), utilisez ces commandes. Avec ces paramètres, AzCopy ne recherche pas ou ne tente pas d’utiliser un proxy.
| Système d’exploitation | Environnement | Commandes |
|---|---|---|
| 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 ne souhaitez pas utiliser de proxy.