Paramètres de configuration d’AzCopy v10 (Stockage Azure)

  • Article

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.

Voir aussi