azcopy copy
Copie les données sources vers un emplacement de destination.
Synopsis
Copie les données sources vers un emplacement de destination. Les directions prises en charge sont les suivantes :
- Local <-> Objet blob Azure (authentification SAP ou OAuth)
- Local <-> Azure Files (authentification SAS pour répertoire/partage)
- Local <-> Azure Data Lake Storage Gen2 (authentification SAS, OAuth ou par clé partagée)
- Objet blob Azure (SAS ou public) -> Objet blob Azure (authentification SAS ou OAuth)
- Azure Data Lake Storage Gen2 (SAP ou public) –> Azure Data Lake Storage Gen2 (authentification SAP ou OAuth)
- Objet blob Azure (authentification SAS ou OAuth) <–> Objet blob Azure (authentification SAS ou OAuth) – Consultez Recommandations.
- Azure Data Lake Storage Gen2 (authentification SAP ou OAuth) <–> Azure Data Lake Storage Gen2 (authentification SAP ou OAuth)
- Azure Data Lake Storage Gen2 (authentification SAP ou OAuth) <–> Azure Blob (authentification SAP ou OAuth)
- Objet blob Azure (SAS ou public) -> Azure Files (SAS)
- Azure Files (SAS) -> Azure Files (SAS)
- Azure Files (SAS) -> Objet blob Azure (authentification SAS ou OAuth)
- AWS S3 (clé d’accès) -> Objet blob de blocs Azure (authentification SAS ou OAuth)
- Google Cloud Storage (clé de compte de service) -> Objet blob de blocs Azure (authentification SAS ou OAuth)
Pour plus d’informations, consultez les exemples.
Avancé
AzCopy détecte automatiquement le type de contenu des fichiers lorsque vous les chargez à partir du disque local, en se basant sur l’extension du fichier ou sur son contenu (si aucune extension n’est spécifiée).
La table de recherche intégrée contient peu de données. Toutefois, sur UNIX, elle est augmentée par le ou les fichiers mime.types (si disponibles) du système local, qui peuvent porter les noms suivants :
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
Sur Windows, les types MIME sont extraits du Registre. Cette fonctionnalité peut être désactivée à l’aide d’un indicateur. Pour plus d’informations, consultez la section relative aux indicateurs.
Si vous définissez une variable d’environnement à l’aide de la ligne de commande, la variable est lisible dans votre historique de ligne de commande. Vous pouvez supprimer de l’historique de la ligne de commande les variables qui contiennent des informations d’identification. Pour empêcher l’affichage des variables dans votre historique, vous pouvez utiliser un script qui invite l’utilisateur à entrer ses informations d’identification et qui définit la variable d’environnement.
azcopy copy [source] [destination] [flags]
Articles conceptuels associés
- Bien démarrer avec AzCopy
- Transférer des données avec AzCopy et le Stockage Blob
- Transférer des données avec AzCopy et le stockage de fichiers
Exemples
Charger un fichier à l’aide de l’authentification OAuth. Si vous n’avez pas encore ouvert de session dans AzCopy, exécutez la commande azcopy login avant la commande suivante.
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"
Comme ci-dessus, mais cette fois-ci, calcule également le hachage MD5 du contenu du fichier et l’enregistre en tant que propriété Content-MD5 de l’objet blob :
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5
Charger un seul fichier à l’aide d’un jeton SAS :
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Charger un seul fichier à l’aide d’un jeton SAS et du piping (objets blob de blocs uniquement) :
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob
Charger un seul fichier à l’aide d’OAuth et du pipe (objets blob de blocs uniquement) :
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob
Charger un répertoire entier à l’aide d’un jeton SAS :
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
or
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5
Charger un ensemble de fichiers à l’aide d’un jeton SAS et de caractères génériques (*) :
azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"
Charger des fichiers et des répertoires à l’aide d’un jeton SAS et de caractères génériques (*) :
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Charger des fichiers et des répertoires dans le compte de stockage Azure et définir les balises encodées de chaîne de requête sur l’objet blob.
- Pour définir les balises {key = "bla bla", val = "foo"} et {key = "bla bla 2", val = "bar"}, utilisez la syntaxe suivante :
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"- Les clés et les valeurs sont encodées en URL et les paires clé-valeur sont séparées par une esperluette ('&')
- Lors du paramétrage des balises sur les objets blob, il existe davantage d’autorisations (« t » pour les balises) dans SAS, sans lesquelles le service renvoie une erreur d’autorisation.
Télécharger un seul fichier à l’aide de l’authentification OAuth. Si vous n’avez pas encore ouvert de session dans AzCopy, exécutez la commande azcopy login avant la commande suivante.
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"
Télécharger un seul fichier à l’aide d’un jeton SAS :
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
Télécharger un seul fichier à l’aide d’un jeton SAS, puis diriger la sortie vers un fichier (objets blob de blocs uniquement) :
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"
Télécharger un seul fichier à l’aide d’OAuth, puis utiliser le pipe pour diriger la sortie vers un fichier (objets blob de blocs uniquement) :
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"
Télécharger un répertoire entier à l’aide d’un jeton SAS :
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true
Remarque sur l’utilisation d’un caractère générique (*) dans les URL :
Il existe seulement deux façons d’utiliser un caractère générique dans une URL.
Vous pouvez en utiliser un juste après la barre oblique finale (/) d’une URL. Cela copie tous les fichiers d’un répertoire directement vers la destination sans les placer dans un sous-répertoire.
Vous pouvez également en utiliser un dans le nom d’un conteneur, tant que l’URL fait uniquement référence à un conteneur et non à un objet blob. Vous pouvez adopter cette approche pour obtenir des fichiers à partir d’un sous-ensemble de conteneurs.
Télécharger le contenu d’un répertoire sans copier le répertoire contenant lui-même.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
Télécharger l’intégralité d’un compte de stockage.
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
Télécharger un sous-ensemble de conteneurs dans un compte de stockage en utilisant un caractère générique (*) dans le nom du conteneur.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive
Télécharger toutes les versions d’un objet blob du Stockage Azure vers le répertoire local. La source doit être un objet blob valide, la destination un dossier local. versionidsFile prend un chemin du fichier où chaque version est écrite sur une ligne distincte. Toutes les versions spécifiées sont téléchargées dans le dossier de destination spécifié.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"
Copier un seul objet blob vers un autre objet blob à l’aide d’un jeton SAS.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Copier un seul objet blob dans un autre objet blob à l’aide d’un jeton SAS et d’un jeton OAuth.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"
Copier un répertoire virtuel d’objets blob vers un autre à l’aide d’un jeton SAS :
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Copier tous les conteneurs d’objets blob, les répertoires et les objets blob du compte de stockage vers un autre à l’aide d’un jeton SAS :
azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Copier un seul objet dans le stockage d’objets blob à partir d’Amazon Web Services (AWS) S3 à l’aide d’une clé d’accès et d’un jeton SAS. Tout d’abord, définissez les variables d’environnement AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY pour la source AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Copier l’intégralité d’un répertoire dans le stockage d’objets blob à partir d’AWS S3 à l’aide d’une clé d’accès et d’un jeton SAS. Tout d’abord, définissez les variables d’environnement AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY pour la source AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Reportez-vous à https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html pour mieux comprendre l’espace réservé [dossier].
Copier tous les compartiments dans le stockage d’objets blob à partir d’Amazon Web Services (AWS) à l’aide d’une clé d’accès et d’un jeton SAS. Tout d’abord, définissez les variables d’environnement AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY pour la source AWS S3.
azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Copier tous les compartiments dans le stockage d’objets blob à partir d’une région Amazon Web Services (AWS) à l’aide d’une clé d’accès et d’un jeton SAS. Tout d’abord, définissez les variables d’environnement AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY pour la source AWS S3.
azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Copier un sous-ensemble de compartiments en utilisant un caractère générique (*) dans le nom du compartiment. Comme dans les exemples précédents, vous avez besoin d’une clé d’accès et d’un jeton SAS. N’oubliez pas de définir les variables d’environnement AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY pour la source S3.
azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Copier des objets blob d’un stockage blob vers un autre en conservant les balises de la source avec la syntaxe suivante :
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --s2s-preserve-blob-tags=true
Transférez des fichiers et des répertoires dans le compte de stockage Azure et définir les balises encodées de chaîne de requête données sur l’objet blob.
Pour définir les balises {key = "bla bla", val = "foo"} et {key = "bla bla 2", val = "bar"}, utilisez la syntaxe suivante :
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"Les clés et les valeurs sont encodées en URL et les paires clé-valeur sont séparées par une esperluette ('&')
Lors de la définition des balises sur les objets blob, il existe des autorisations supplémentaires (« t ») dans SAS, sans lesquelles le service renvoie une erreur d’autorisation.
Copier un seul objet dans le Stockage Blob à partir de Google Cloud Storage (GCS) à l’aide d’une clé de compte de service et d’un jeton SAS. La variable d’environnement GOOGLE_APPLICATION_CREDENTIALS doit d’abord être définie pour la source GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Copier l’intégralité d’un répertoire dans le Stockage Blob à partir de GCS à l’aide d’une clé de compte de service et d’un jeton SAS. La variable d’environnement GOOGLE_APPLICATION_CREDENTIALS doit d’abord être définie pour la source GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Copier l’intégralité d’un compartiment dans le Stockage Blob à partir de GCS à l’aide d’une clé de compte de service et d’un jeton SAS. La variable d’environnement GOOGLE_APPLICATION_CREDENTIALS doit d’abord être définie pour la source GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Copier tous les compartiments dans le Stockage Blob à partir de GCS à l’aide d’une clé de compte de service et d’un jeton SAS. Les variables d’environnement GOOGLE_APPLICATION_CREDENTIALS et GOOGLE_CLOUD_PROJECT=<project-id> doivent d’abord être définies pour la source GCS.
azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Copier une partie des compartiments à l’aide d’un symbole de caractère générique (*) dans le nom du compartiment à partir de GCS à l’aide d’une clé de compte de service et d’un jeton SAS pour la destination. Les variables d’environnement GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> doivent d’abord être définies pour la source GCS.
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Options
--as-subdir (par défaut true) : place les sources de dossiers en tant que sous-répertoires sous la destination. (par défaut : true)
--backup : active le privilège SeBackupPrivilege de Windows pour les chargements, ou SeRestorePrivilege pour les téléchargements, afin de permettre à AzCopy de lire tous les fichiers, indépendamment des autorisations de leur système de fichiers, et de restaurer toutes les autorisations. Le compte qui exécute AzCopy doit déjà disposer de ces autorisations (par exemple posséder des droits d’administrateur ou être membre du groupe « Opérateurs de sauvegarde »). Cet indicateur active les privilèges que le compte détient déjà.
--blob-tags (chaîne) : définit des balises sur les objets blob pour catégoriser les données du compte de stockage.
--blob-type (chaîne) : définit le type d’objet blob au niveau de la destination. Utilisé pour charger des objets blob et lors de la copie de données d’un compte à l’autre (par défaut « Detect »). Les valeurs valides sont « Detect », « BlockBlob », « PageBlob » et « AppendBlob ». Lors de la copie entre comptes, la valeur « Detect » contraint AzCopy à utiliser le type de l’objet blob source pour déterminer le type de l’objet blob de destination. Lors du chargement d’un fichier, « Detect » détermine s’il s’agit d’un fichier VHD ou VHDX en fonction de l’extension de fichier. S’il s’agit d’un fichier VHD ou VHDX, AzCopy le traite comme un objet blob de pages. (par défaut : « Detect »)
--block-blob-tier (chaîne) : charge un objet blob de blocs dans le Stockage Azure à l’aide de ce niveau d’objet blob. (par défaut : « None »).
--block-size-mb (flottant) : utilise cette taille de bloc (spécifiée en Mio) lors du chargement dans le Stockage Azure et du téléchargement à partir de Stockage Azure. La valeur par défaut est calculée automatiquement en fonction de la taille du fichier. Les fractions décimales sont autorisées (par exemple : 0,25). Lors du chargement ou du téléchargement, la taille de bloc maximale autorisée est de 0,75 * AZCOPY_BUFFER_GB. Pour en savoir plus, consultez Optimiser l’utilisation de la mémoire.
--cache-control (chaîne) : définit l’en-tête cache-control. Retourné au moment du téléchargement.
--check-length Vérifier la longueur d’un fichier sur la destination après le transfert. En cas d’incompatibilité entre la source et la destination, le transfert est marqué comme ayant échoué. (par défaut : true)
--check-md5 (chaîne) : spécifie la manière plus ou moins stricte dont les hachages MD5 doivent être validés lors du téléchargement. Disponible uniquement lors du téléchargement. Options disponibles : NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (par défaut : « FailIfDifferent »)
--content-disposition (chaîne) : définit l’en-tête content-disposition. Retourné au moment du téléchargement.
--content-encoding (chaîne) : définit l’en-tête content-encoding. Retourné au moment du téléchargement.
--content-language (chaîne) : définit l’en-tête content-language. Retourné au moment du téléchargement.
--content-type (chaîne) : spécifie le type de contenu du fichier. Implique l’utilisation de no-guess-mime-type. Retourné au moment du téléchargement.
--cpk-by-name (chaîne) : clé fournie par le client par nom permettant aux clients qui effectuent des demandes auprès du Stockage Blob Azure de fournir une clé de chiffrement pour chaque demande. Le nom de la clé fournie est récupéré dans Azure Key Vault et est utilisé pour chiffrer les données
--cpk-by-value : clé fournie par le client par nom permettant aux clients qui effectuent des demandes auprès du Stockage Blob Azure de fournir une clé de chiffrement pour chaque demande. La clé fournie et son code de hachage sont récupérés à partir des variables d’environnement
--decompress : décompresse automatiquement les fichiers lors du téléchargement si content-encoding indique qu’ils sont compressés. Les valeurs de content-encoding prises en charge sont « gzip » et « deflate ». Les extensions de fichiers « .gz »/« .gzip » ou « .zz » ne sont pas nécessaires, mais sont supprimées si elles sont présentes.
--disable-auto-decoding False par défaut pour activer le décodage automatique de caractères non conformes sur Windows. Cet indicateur peut être défini sur true pour désactiver le décodage automatique.
--dry-run Imprime le chemin des fichiers qui seraient copiés par cette commande. Cet indicateur ne copie pas les fichiers réels. L’indicateur --overwrite n’a aucun effet. Si vous définissez l’indicateur --overwrite sur false, les fichiers du répertoire source sont listés, même si ces fichiers existent dans le répertoire de destination.
--exclude-attributes (string) (Windows uniquement) Exclut les fichiers dont les attributs correspondent à la liste d’attributs. Par exemple : A;S;R
--exclude-blob-type (chaîne) (facultatif) : spécifie le type d’objet blob (BlockBlob, PageBlob ou AppendBlob) à exclure lors de la copie des objets blob à partir du conteneur ou du compte. Cet indicateur ne s’applique pas à la copie de données à partir d’un service extérieur à Azure. Si vous avez plusieurs objets blob, vous devez les séparer par un point-virgule (« ; »).
--exclude-path (chaîne) : exclut ces chemins lors de la copie. Cette option ne prend pas en charge les caractères génériques (*). Vérifie le préfixe de chemin relatif (Par exemple : myFolder;myFolder/subDirName/file.pdf.) En cas d’utilisation combinée avec la traversée de comptes, les chemins n’incluent pas le nom du conteneur.
--exclude-pattern (chaîne) : exclut ces fichiers lors de la copie. Cette option prend en charge les caractères génériques (*).
--exclude-regex (chaîne) : exclut tout le chemin relatif des fichiers qui correspondent à des expressions régulières. Séparez les expressions régulières par des points-virgules (;).
--follow-symlinks : suit les liens symboliques lors du chargement à partir d’un système de fichiers local.
--force-if-read-only : force le remplacement d’un fichier existant sur Windows ou Azure Files à fonctionner même si l’attribut read-only est défini sur ce fichier.
--from-to (chaîne) (facultatif) : spécifie la combinaison source-destination. Par exemple : LocalBlob, BlobLocal, LocalBlobFS. Piping : BlobPipe, PipeBlob.
-h, --help : fournit de l’aide pour la copie.
--include-after (chaîne) : inclut uniquement les fichiers modifiés après la date et l’heure données. La valeur doit être au format ISO8601. Si aucun fuseau horaire n’est spécifié, la valeur est supposée être dans le fuseau horaire local de l’ordinateur exécutant AzCopy. Exemples : 2020-08-19T15:04:00Z pour une heure UTC, 2020-08-19 pour minuit (00:00) dans le fuseau horaire local. À partir de la version 10.5 d’AzCopy, cet indicateur s’applique uniquement aux fichiers, et non aux dossiers. Les propriétés de dossier ne sont donc pas copiées lorsque cet indicateur est utilisé avec --preserve-smb-info ou --preserve-smb-permissions.
--include-attributes (chaîne) (Windows uniquement) : inclut les fichiers dont les attributs correspondent à la liste d’attributs. Par exemple : A;S;R
--include-before (chaîne) : inclut uniquement les fichiers modifiés avant ou à la date et l’heure données. La valeur doit être au format ISO8601. Si aucun fuseau horaire n’est spécifié, la valeur est supposée être dans le fuseau horaire local de l’ordinateur exécutant AzCopy. Par exemple, 2020-08-19T15:04:00Z pour une heure UTC, ou 2020-08-19 pour minuit (00:00) dans le fuseau horaire local. À partir d’AzCopy 10.7, cet indicateur s’applique uniquement aux fichiers, et non aux dossiers. Les propriétés de dossier ne sont donc pas copiées lors de l’utilisation de cet indicateur avec --preserve-smb-info ou --preserve-smb-permissions.
--include-directory-stub False par défaut pour ignorer les stubs de répertoire. Les stubs de répertoire sont des objets blob dotés des métadonnées hdi_isfolder:true. Si vous définissez la valeur sur true, les stubs de répertoire seront conservés pendant les transferts. L’inclusion de cet indicateur sans valeur par défaut est true (par exemple,azcopy copy --include-directory-stub est identique à azcopy copy --include-directory-stub=true).
--include-path (chaîne) : inclut uniquement ces chemins lors de la copie. Cette option ne prend pas en charge les caractères génériques (*). Vérifie le préfixe de chemin relatif (Par exemple : myFolder;myFolder/subDirName/file.pdf.).
--include-pattern (chaîne) : inclut uniquement ces fichiers lors de la copie. Cette option prend en charge les caractères génériques (*). Séparez les fichiers à l’aide d’un signe « ; ».
--include-regex (chaîne) : inclut uniquement le chemin relatif des fichiers qui correspondent à des expressions régulières. Séparez les expressions régulières par des points-virgules (;).
--list-of-versions (chaîne) : spécifie un fichier dans lequel chaque ID de version figure sur une ligne distincte. Assurez-vous que la source pointe vers un blob unique et que tous les ID de version spécifiés dans le fichier à l’aide de cet indicateur appartiennent uniquement au blob source. AzCopy télécharge les versions spécifiées dans le dossier de destination indiqué.
--log-level (chaîne) : définit la verbosité des journaux du fichier journal. Niveaux disponibles : INFO (toutes les demandes et réponses), WARNING (les réponses lentes), ERROR (uniquement les échecs de demandes) et NONE (aucun journal de sortie). (par défaut : « INFO ») (par défaut : « INFO »)
--metadata (chaîne) : charge dans le Stockage Azure ces paires clé-valeur comme métadonnées.
--no-guess-mime-type : empêche AzCopy de détecter content-type en fonction de l’extension ou du contenu du fichier.
--overwrite (chaîne) : remplace les fichiers et objets blob en conflit dans la destination. Valeurs possibles : « true », « false », « prompt » et « ifSourceNewer » (par défaut « true »). Dans le cas des destinations qui prennent en charge les dossiers, les propriétés au niveau dossier en conflit sont remplacées si cet indicateur a la valeur « true » ou si une réponse positive est fournie à l’invite. (par défaut : « true »)
--page-blob-tier (chaîne) : charge un objet blob de pages dans le Stockage Azure à l’aide de ce niveau d’objet blob. (par défaut : « None »). (par défaut : « None »).
--preserve-last-modified-time : disponible uniquement quand la destination est un système de fichiers.
--preserve-owner N’a d’effet que dans les téléchargements, et uniquement quand --preserve-smb-permissions est utilisé. Si la valeur est true (valeur par défaut), le groupe et le propriétaire des fichiers sont conservés dans les téléchargements. Si la valeur est false,
--preserve-smb-permissions conserve toujours les listes de contrôle d’accès, mais le propriétaire et le groupe sont basés sur l’utilisateur qui exécute AzCopy (true par défaut)
--preserve-permissions (false par défaut) : préserve les listes de contrôle d’accès entre les ressources sensibles (Windows et Azure Files, ou Azure Data Lake Storage Gen2 vers Azure Data Lake Storage Gen2). Pour les comptes disposant d’un espace de noms hiérarchique, votre principal de sécurité doit être l’utilisateur propriétaire du conteneur cible ou être affecté au rôle Propriétaire des données blob de stockage, limité au conteneur cible, au compte de stockage, au groupe de ressources parent ou à l’abonnement. Pour les téléchargements, vous devez également utiliser l’indicateur --backup pour restaurer les autorisations où le nouveau propriétaire n’est pas l’utilisateur qui exécute AzCopy. Cet indicateur s’applique aux fichiers et aux dossiers, à moins qu’un filtre de fichier uniquement soit spécifié (par exemple, include-pattern).
--preserve-smb-info : true par défaut pour les emplacements prenant en charge SMB. Conserve les informations de propriété SMB (heure de la dernière écriture, heure de création, bits d’attribut) entre les ressources prenant en charge SMB (Windows et Azure Files). Seuls les bits d’attribut pris en charge par Azure Files sont transférés ; les autres sont ignorés. Cet indicateur s’applique aux fichiers et aux dossiers, à moins qu’un filtre de fichier uniquement soit spécifié (par exemple, include-pattern). Les informations transférées pour les dossiers sont les mêmes que pour les fichiers, à l’exception de Last Write Time qui n’est jamais conservé pour les dossiers. (par défaut : true)
--preserve-symlinks Si cette option est activée, les destinations symlink sont conservées en tant que contenu d’objet blob, au lieu de charger le fichier ou le dossier à l’autre extrémité du lien symbolique.
--put-blob-size-mbUtilisez cette taille (spécifiée en MiB) comme seuil pour déterminer s’il faut charger un objet blob en tant que requête PUT unique lors du chargement sur Stockage Azure. La valeur par défaut est calculée automatiquement en fonction de la taille du fichier. Les fractions décimales sont autorisées (par exemple : 0,25).
--put-md5 Créer un hachage MD5 de chaque fichier, puis enregistrer le hachage en tant que propriété Content-MD5 de l’objet blob ou du fichier de destination. (par défaut, le hachage n’est pas créé.) Disponible uniquement lors du chargement.
--recursive : examine le contenu des sous-répertoires de manière récursive lors du chargement à partir du système de fichiers local.
--s2s-detect-source-changed : Détecter si le fichier source/l’objet blob change pendant sa lecture. (Ce paramètre s’applique uniquement aux copies de service à service, car la vérification correspondante est activée de manière permanente pour les chargements et les téléchargements.)
--s2s-handle-invalid-metadata (chaîne) : spécifie la manière dont les clés de métadonnées non valides sont gérées. Options disponibles : ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid (par défaut : « ExcludeIfInvalid »). (par défaut : « ExcludeIfInvalid »)
--s2s-preserve-access-tier : préserve le niveau d’accès lors de la copie de service à service. Pour vérifier si le compte de stockage de destination prend en charge la définition du niveau d’accès, consultez Stockage Blob Azure : niveaux d’accès chaud, froid et archive. Si la définition du niveau d’accès n’est pas prise en charge, veillez à utiliser s2sPreserveAccessTier=false pour contourner la copie du niveau d’accès. (par défaut : true) (par défaut : true)
--s2s-preserve-blob-tags : préserve les balises d’index pendant le transfert de service à service d’un stockage blob à un autre.
--s2s-preserve-properties : préserve l’intégralité des propriétés lors de la copie de service à service. Pour une source de fichier non unique Azure Files et AWS S3, l’opération de liste ne retourne pas les propriétés complètes des objets et des fichiers. Pour conserver l’intégralité des propriétés, AzCopy doit envoyer une demande supplémentaire par objet ou fichier. (par défaut : true)
Options héritées des commandes parentes
--cap-mbps (flottant) Limite la vitesse de transfert, en mégabits par seconde. Par moment, le débit peut dépasser légèrement cette limite. Si cette option est définie sur zéro ou si elle est omise, le débit n’est pas limité.
--output-type (string) Met en forme la sortie de la commande. Les formats possibles sont « text » et « JSON ». La valeur par défaut est « text ». (par défaut : « text »).
--trusted-microsoft-suffixes (chaîne) Spécifie des suffixes supplémentaires de domaine dans lesquels les jetons de connexion Microsoft Entra peuvent être envoyés. La valeur par défaut est « .core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net ». Tous les éléments répertoriés ici sont ajoutés à la valeur par défaut. Pour la sécurité, vous devez placer uniquement des domaines Microsoft Azure ici. Séparez plusieurs entrées par des points-virgules.