Partager via


azcopy copy

Copie les données sources vers un emplacement de destination.

Remarque

AzCopy ne prend pas en charge les scénarios où la source ou la destination est activement modifiée pendant le transfert.

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 SAP share/directory ou authentification OAuth)
  • local <-> Azure Data Lake Storage (authentification SAP, OAuth ou SharedKey)
  • Objet blob Azure (SAS ou public) -> Objet blob Azure (authentification SAS ou OAuth)
  • Azure Data Lake Storage (SAP ou public) -> Azure Data Lake Storage (authentification SAP ou OAuth)
  • Objet blob Azure (authentification SAS ou OAuth) <–> Objet blob Azure (authentification SAS ou OAuth) – Consultez Recommandations.
  • Azure Data Lake Storage (authentification SAP ou OAuth) - <> Azure Data Lake Storage (authentification SAP ou OAuth)
  • Azure Data Lake Storage (authentification SAP ou OAuth) - <> Objet blob Azure (authentification SAP ou OAuth)
  • Objet blob Azure (SAS ou public) -> Azure Files (SAS)
  • Fichier Azure (authentification SAS ou OAuth) - <> Fichier Azure (authentification SAS ou OAuth)
  • 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]

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échargez toutes les versions d’un objet blob à partir de Stockage Azure répertoriées dans un fichier texte (par exemple : versionidsFile) dans le répertoire local. Vérifiez que la source est un objet blob valide, que la destination est un dossier local et versionidsFile qu’elle est un fichier texte 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

Pour copier des fichiers modifiés avant ou après le démarrage du travail AzCopy, AzCopy fournit la date et l’heure dans le journal des travaux au format ISO8601 (recherchez « ISO 8601 START TIME » dans le journal des travaux) qui peuvent être utilisées avec les indicateurs et --include-before les --include-after indicateurs, consultez les exemples ci-dessous. Cela est utile pour les copies incrémentielles.

Copiez un sous-ensemble de fichiers modifiés ou après la date et l’heure spécifiées (au format ISO8601) dans un conteneur à l’aide de l’indicateur include-after .

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-after="2020-08-19T15:04:00Z"

Copiez un sous-ensemble de fichiers modifiés ou avant la date et l’heure spécifiées (au format ISO8601) dans un conteneur à l’aide de l’indicateur include-before .

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-before="2020-08-19T15:04:00Z"

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 (false par défaut) : Le client fourni par un nom qui permet aux clients d’effectuer des requêtes sur le stockage Blob Azure, une option permettant de fournir une clé de chiffrement par 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 (false par défaut) : Imprime les chemins d’accès au fichier 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-container (chaîne) Excluez ces conteneurs lors du transfert d’un compte vers un compte uniquement. Plusieurs conteneurs peuvent être séparés par « ; ».

--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é.

--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) : Conserve les listes de contrôle d’accès entre les ressources prenant en compte (Windows et Azure Files, ou Azure Data Lake Storage vers Azure Data Lake Storage). 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-posix-properties (false par défaut) : Conserve les informations de propriété extraites ou stat statx dans les métadonnées d’objet.

--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 (false par défaut) : Conserver les étiquettes d’index pendant le transfert de service à service d’un stockage d’objets blob vers 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)

--trailing-dot Activé par défaut pour traiter les opérations liées au partage de fichiers de manière sécurisée. Options disponibles : Enable, Disable. Choisissez Disable de revenir au traitement hérité (potentiellement dangereux) des fichiers de points de fin dans lesquels le service de fichiers supprime les points de fin dans les chemins. Cela peut entraîner une altération potentielle des données si le transfert contient deux chemins qui diffèrent uniquement par un point de fin (par exemple mypath et mypath.). Si cet indicateur est défini Disable sur et qu’AzCopy rencontre un fichier point de fin, il avertit les clients dans le journal d’analyse, mais ne tente pas d’abandonner l’opération. Si la destination ne prend pas en charge les fichiers points de fin (Windows ou Stockage Blob), AzCopy échoue si le fichier point de fin est la racine du transfert et ignore les chemins de points de fin rencontrés pendant l’énumération.

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é.

--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 »)

--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.

Voir aussi