azcopy syncazcopy sync

Réplique l’emplacement source vers l’emplacement de destination.Replicates the source location to the destination location.

SynopsisSynopsis

Les heures de dernière modification sont utilisées à des fins de comparaison.The last modified times are used for comparison. Le fichier est ignoré si l’heure de dernière modification de l’emplacement de destination est plus récente.The file is skipped if the last modified time in the destination is more recent.

Les paires prises en charge sont les suivantes :The supported pairs are:

  • Local <-> Objet blob Azure (authentification SAP ou OAuth)local <-> Azure Blob (either SAS or OAuth authentication can be used)
  • Objet blob Azure <-> objet blob Azure (la source doit inclure une signature d’accès partagé (SAP) ou est accessible au public ; l’authentification SAP ou OAuth peut être utilisée pour la destination)Azure Blob <-> Azure Blob (Source must include a SAS or is publicly accessible; either SAS or OAuth authentication can be used for destination)
  • Fichier Azure <-> fichier Azure (la source doit inclure une signature d’accès partagé (SAP) ou est accessible au public ; l’authentification SAP doit être utilisée pour la destination)Azure File <-> Azure File (Source must include a SAS or is publicly accessible; SAS authentication should be used for destination)

Il existe plusieurs différences entre la commande sync et la commande copy :The sync command differs from the copy command in several ways:

  1. Par défaut, l’indicateur récursif possède la valeur true et la synchronisation copie tous les sous-répertoires.By default, the recursive flag is true and sync copies all subdirectories. La synchronisation copie uniquement les fichiers de niveau supérieur à l’intérieur d’un répertoire si l’indicateur récursif possède la valeur false.Sync only copies the top-level files inside a directory if the recursive flag is false.
  2. Lors de la synchronisation entre répertoires virtuels, ajoutez une barre oblique finale au chemin d’accès (voir exemples) s’il existe un objet blob portant le même nom que l’un des répertoires virtuels.When syncing between virtual directories, add a trailing slash to the path (refer to examples) if there's a blob with the same name as one of the virtual directories.
  3. Si l’indicateur « deleteDestination » est défini sur true ou prompt, la synchronisation supprime les fichiers et objets blob de destination qui ne sont pas présents au niveau de la source.If the deleteDestination flag is set to true or prompt, then sync will delete files and blobs at the destination that are not present at the source.

AvancéAdvanced

Si vous n’indiquez pas d’extension de fichier, 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).If you don't specify a file extension, AzCopy automatically detects the content type of the files when uploading from the local disk, based on the file extension or content (if no extension is specified).

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 :The built-in lookup table is small, but on Unix, it's augmented by the local system's mime.types file(s) if available under one or more of these names:

  • /etc/mime.types/etc/mime.types
  • /etc/apache2/mime.types/etc/apache2/mime.types
  • /etc/apache/mime.types/etc/apache/mime.types

Sur Windows, les types MIME sont extraits du Registre.On Windows, MIME types are extracted from the registry.

azcopy sync <source> <destination> [flags]

ExemplesExamples

Synchroniser un fichier :Sync a single file:

azcopy sync "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

Comme ci-dessus, mais calcule également le hachage MD5 du contenu du fichier et l’enregistre en tant que propriété Content-MD5 de l’objet blob.Same as above, but also compute an MD5 hash of the file content, and then save that MD5 hash as the blob's Content-MD5 property.

azcopy sync "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5

Synchroniser l’intégralité d’un répertoire, y compris ses sous-répertoires (notez que la récursivité est activée par défaut) :Sync an entire directory including its subdirectories (note that recursive is by default on):

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]"

oror

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --put-md5

Synchronisez uniquement les fichiers à l’intérieur d’un répertoire, mais pas les sous-répertoires ou les fichiers à l’intérieur des sous-répertoires :Sync only the files inside of a directory but not subdirectories or the files inside of subdirectories:

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=false

Synchroniser un sous-ensemble de fichiers dans un répertoire (par exemple, uniquement les fichiers .jpg et PDF, ou uniquement les fichiers dont le nom est « exactName ») :Sync a subset of files in a directory (For example: only jpg and pdf files, or if the file name is exactName):

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --include-pattern="*.jpg;*.pdf;exactName"

Synchroniser l’intégralité d’un répertoire, mais exclure certains fichiers (par exemple, tous ceux dont le nom commence par « foo » ou se termine par « bar ») :Sync an entire directory but exclude certain files from the scope (For example: every file that starts with foo or ends with bar):

azcopy sync "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --exclude-pattern="foo*;*bar"

Synchronisez un objet blob :Sync a single blob:

azcopy sync "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

Synchroniser un répertoire virtuel :Sync a virtual directory:

azcopy sync "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]?[SAS]" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=true

Synchronisez un répertoire virtuel portant le même nom qu’un objet blob (ajoutez une barre oblique finale au chemin d’accès pour lever l’ambiguïté) :Sync a virtual directory that has the same name as a blob (add a trailing slash to the path in order to disambiguate):

azcopy sync "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]/?[SAS]" "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]/" --recursive=true

Synchronisez un répertoire Azure File (même syntaxe que l’objet blob) :Sync an Azure File directory (same syntax as Blob):

azcopy sync "https://[account].file.core.windows.net/[share]/[path/to/dir]?[SAS]" "https://[account].file.core.windows.net/[share]/[path/to/dir]" --recursive=true

Notes

Si les indicateurs include/exclude sont utilisés ensemble, seuls les fichiers correspondant aux caractères génériques include sont examinés. Ceux qui correspondent aux caractères génériques exclude seront toujours ignorés.If include/exclude flags are used together, only files matching the include patterns would be looked at, but those matching the exclude patterns would be always be ignored.

OptionsOptions

--block-size-mb float Taille de bloc (spécifiée en Mio) utilisée lors du chargement dans Stockage Azure ou le téléchargement à partir de Stockage Azure.--block-size-mb float Use this block size (specified in MiB) when uploading to Azure Storage or downloading from Azure Storage. La valeur par défaut est calculée automatiquement en fonction de la taille du fichier.Default is automatically calculated based on file size. Les fractions décimales sont autorisées (par exemple : 0.25).Decimal fractions are allowed (For example: 0.25).

--check-md5 string Spécifie la manière dont les hachages MD5 doivent être validés lors du téléchargement.--check-md5 string Specifies how strictly MD5 hashes should be validated when downloading. Disponible uniquement lors du téléchargement.This option is only available when downloading. Les valeurs disponibles sont les suivantes : NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing.Available values include: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (par défaut FailIfDifferent).(default FailIfDifferent). (valeur par défaut FailIfDifferent)(default FailIfDifferent)

--delete-destination string Détermine si les fichiers de l’emplacement de destination qui ne sont pas présents dans l’emplacement source doivent être supprimés.--delete-destination string Defines whether to delete extra files from the destination that are not present at the source. Peut être défini sur true, false, ou prompt.Could be set to true, false, or prompt. Si la valeur est définie sur prompt, l’utilisateur est invité à répondre à une question avant de planifier la suppression des fichiers et des objets blob.If set to prompt, the user will be asked a question before scheduling files and blobs for deletion. (par défaut false).(default false). (valeur par défaut false)(default false)

--exclude-attributes string (Windows uniquement) Exclut les fichiers dont les attributs correspondent à la liste d’attributs.--exclude-attributes string (Windows only) Excludes files whose attributes match the attribute list. Par exemple : A;S;RFor example: A;S;R

--exclude-path string Exclut ces chemins d’accès lorsque la source est comparée à la destination.--exclude-path string Exclude these paths when comparing the source against the destination. Cette option ne prend pas en charge les caractères génériques (*).This option does not support wildcard characters (*). Vérifie le préfixe du chemin d’accès relatif (par exemple, myFolder;myFolder/subDirName/file.pdf).Checks relative path prefix(For example: myFolder;myFolder/subDirName/file.pdf).

Chaîne --exclude-pattern Exclut les fichiers dont le nom correspond à la liste de caractères génériques.--exclude-pattern string Exclude files where the name matches the pattern list. Par exemple : *.jpg;*.pdf;exactNameFor example: *.jpg;*.pdf;exactName

--help Aide pour la synchronisation.--help help for sync.

--include-attributes string (Windows uniquement) Inclut uniquement les fichiers dont les attributs correspondent à la liste d’attributs.--include-attributes string (Windows only) Includes only files whose attributes match the attribute list. Par exemple : A;S;RFor example: A;S;R

Chaîne --include-pattern Inclut uniquement les fichiers dont le nom correspond à la liste de caractères génériques.--include-pattern string Include only files where the name matches the pattern list. Par exemple : *.jpg;*.pdf;exactNameFor example: *.jpg;*.pdf;exactName

--log-level string Définit le niveau de détail pour le fichier journal. Niveaux disponibles : INFO(toutes les demandes et réponses), WARNING(réponses lentes), ERROR(uniquement les demandes ayant échoué) et NONE(aucun journal de sortie).--log-level string Define the log verbosity for the log file, available levels: INFO(all requests and responses), WARNING(slow responses), ERROR(only failed requests), and NONE(no output logs). (par défaut INFO).(default INFO).

--preserve-smb-info False par défaut.--preserve-smb-info False by default. 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).Preserves SMB property info (last write time, creation time, attribute bits) between SMB-aware resources (Windows and Azure Files). Cet indicateur s’applique aux fichiers et aux dossiers, à moins qu’un filtre de fichier uniquement soit spécifié (par exemple, include-pattern).This flag applies to both files and folders, unless a file-only filter is specified (for example, include-pattern).  Les informations transférées pour les dossiers sont les mêmes que pour les fichiers, à l’exception de l’heure de la dernière écriture, qui n’est pas conservée pour les dossiers.The info transferred for folders is the same as that for files, except for Last Write Time that is not preserved for folders.

--preserve-smb-permissions False par défaut.--preserve-smb-permissions False by default. Conserve les listes de contrôle d’accès (ACL) SMB entre les ressources prenant en charge SMB (Windows et Azure Files).Preserves SMB ACLs between aware resources (Windows and Azure Files). Cet indicateur s’applique aux fichiers et aux dossiers, à moins qu’un filtre de fichier uniquement soit spécifié (par exemple, include-pattern).This flag applies to both files and folders, unless a file-only filter is specified (for example, include-pattern).

--put-md5 Crée un hachage MD5 de chaque fichier, puis enregistre le hachage en tant que propriété Content-MD5 de l’objet blob ou du fichier de destination.--put-md5 Create an MD5 hash of each file, and save the hash as the Content-MD5 property of the destination blob or file. (par défaut, le hachage n’est pas créé.) Disponible uniquement lors du chargement.(By default the hash is NOT created.) Only available when uploading.

--recursive True par défaut. Examine les sous-répertoires de manière récursive lors de la synchronisation des répertoires.--recursive True by default, look into subdirectories recursively when syncing between directories. (par défaut True).(default True).

--s2s-preserve-access-tier Conserver le niveau d’accès lors d’une copie de service à service.--s2s-preserve-access-tier Preserve access tier during service to service copy. 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.Refer to Azure Blob storage: hot, cool, and archive access tiers to ensure destination storage account supports setting access tier. Si la définition du niveau d’accès n’est pas prise en charge, utilisez s2sPreserveAccessTier=false pour contourner la copie du niveau d’accès.In the cases that setting access tier is not supported, please use s2sPreserveAccessTier=false to bypass copying access tier. (par défaut true).(default true).

Options héritées des commandes parentesOptions inherited from parent commands

OptionOption DescriptionDescription
--cap-mbps uint32--cap-mbps uint32 Limite la vitesse de transfert, en mégabits par seconde.Caps the transfer rate, in megabits per second. Par moment, le débit peut dépasser légèrement cette limite.Moment-by-moment throughput might vary slightly from the cap. Si cette option est définie sur zéro ou si elle est omise, le débit n’est pas limité.If this option is set to zero, or it is omitted, the throughput isn't capped.
--output-type (chaîne)--output-type string Met en forme la sortie de la commande.Format of the command's output. Les formats possibles sont « text » et « JSON ».The choices include: text, json. La valeur par défaut est « text ».The default value is "text".
--trusted-microsoft-suffixes (chaîne)--trusted-microsoft-suffixes string Spécifie des suffixes de domaine supplémentaires où des jetons de connexion Azure Active Directory peuvent être envoyés.Specifies additional domain suffixes where Azure Active Directory login tokens may be sent. La valeur par défaut est «  .core.windows.net; .core.chinacloudapi.cn; .core.cloudapi.de; .core.usgovcloudapi.net ».The default is '.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.Any listed here are added to the default. Pour la sécurité, vous devez placer uniquement des domaines Microsoft Azure ici.For security, you should only put Microsoft Azure domains here. Séparez plusieurs entrées par des points-virgules.Separate multiple entries with semi-colons.

Voir aussiSee also