Copy blobs between Azure storage accounts by using AzCopy

You can copy blobs, directories, and containers between storage accounts by using the AzCopy v10 command-line utility.

To see examples for other types of tasks such as uploading files, downloading blobs, and synchronizing with Blob storage, see the links presented in the Next Steps section of this article.

AzCopy uses server-to-server APIs, so data is copied directly between storage servers.

Get started

See the Get started with AzCopy article to download AzCopy and learn about the ways that you can provide authorization credentials to the storage service.

Guidelines

Apply the following guidelines to your AzCopy commands.

• If you're using Microsoft Entra authorization for both source and destination, then both accounts must belong to the same Microsoft Entra tenant.

• Your client must have network access to both the source and destination storage accounts. To learn how to configure the network settings for each storage account, see Configure Azure Storage firewalls and virtual networks.

• If you copy to a premium block blob storage account, omit the access tier of a blob from the copy operation by setting the s2s-preserve-access-tier to false (For example: --s2s-preserve-access-tier=false). Premium block blob storage accounts don't support access tiers.

• You can increase the throughput of copy operations by setting the value of the AZCOPY_CONCURRENCY_VALUE environment variable. To learn more, see Increase Concurrency.

• If the source blobs have index tags, and you want to retain those tags, you'll have to reapply them to the destination blobs. For information about how to set index tags, see the Copy blobs to another storage account with index tags section of this article.

Copy a blob

Copy a blob to another storage account by using the azcopy copy command.

Syntax

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>/<blob-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>/<blob-path>'

Example

azcopy copy 'https://mysourceaccount.blob.core.chinacloudapi.cn/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.chinacloudapi.cn/mycontainer/myTextFile.txt'

Example (Data Lake Storage endpoints)

azcopy copy 'https://mysourceaccount.dfs.core.chinacloudapi.cn/mycontainer/myTextFile.txt' 'https://mydestinationaccount.dfs.core.chinacloudapi.cn/mycontainer/myTextFile.txt'

The copy operation is synchronous so when the command returns, that indicates that all files have been copied.

Copy a directory

Copy a directory to another storage account by using the azcopy copy command.

Syntax

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>/<directory-path>' 'https://<destination-storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>' --recursive

Example

azcopy copy 'https://mysourceaccount.blob.core.chinacloudapi.cn/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.chinacloudapi.cn/mycontainer' --recursive

Example (Data Lake Storage endpoints)

azcopy copy 'https://mysourceaccount.dfs.core.chinacloudapi.cn/mycontainer/myBlobDirectory' 'https://mydestinationaccount.dfs.core.chinacloudapi.cn/mycontainer' --recursive

The copy operation is synchronous. All files have been copied when the command returns.

Copy a container

Copy a container to another storage account by using the azcopy copy command.

Syntax

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>' 'https://<destination-storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>' --recursive

Example

azcopy copy 'https://mysourceaccount.blob.core.chinacloudapi.cn/mycontainer' 'https://mydestinationaccount.blob.core.chinacloudapi.cn/mycontainer' --recursive

Example (Data Lake Storage endpoints)

azcopy copy 'https://mysourceaccount.dfs.core.chinacloudapi.cn/mycontainer' 'https://mydestinationaccount.dfs.core.chinacloudapi.cn/mycontainer' --recursive

The copy operation is synchronous. All files have been copied when the command returns.

Copy containers, directories, and blobs

Copy all containers, directories, and blobs to another storage account by using the azcopy copy command.

Syntax

azcopy copy 'https://<source-storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/' 'https://<destination-storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/' --recursive

Example

azcopy copy 'https://mysourceaccount.blob.core.chinacloudapi.cn/' 'https://mydestinationaccount.blob.core.chinacloudapi.cn' --recursive

Example (Data Lake Storage endpoints)

azcopy copy 'https://mysourceaccount.dfs.core.chinacloudapi.cn/' 'https://mydestinationaccount.dfs.core.chinacloudapi.cn' --recursive

The copy operation is synchronous so when the command returns, that indicates that all files have been copied.

Copy blobs and add index tags

Copy blobs to another storage account and add blob index tags to the target blob.

If you're using Microsoft Entra authorization, your security principal must be assigned the Storage Blob Data Owner role, or it must be given permission to the Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write Azure resource provider operation via a custom Azure role. If you're using a Shared Access Signature (SAS) token, that token must provide access to the blob's tags via the t SAS permission.

To add tags, use the --blob-tags option along with a URL encoded key-value pair.

For example, to add the key my tag and a value my tag value, you would add --blob-tags='my%20tag=my%20tag%20value' to the destination parameter.

Separate multiple index tags by using an ampersand (&). For example, if you want to add a key my second tag and a value my second tag value, the complete option string would be --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'.

The following examples show how to use the --blob-tags option.

Blob example

azcopy copy 'https://mysourceaccount.blob.core.chinacloudapi.cn/mycontainer/myTextFile.txt' 'https://mydestinationaccount.blob.core.chinacloudapi.cn/mycontainer/myTextFile.txt' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Directory example

azcopy copy 'https://mysourceaccount.blob.core.chinacloudapi.cn/mycontainer/myBlobDirectory' 'https://mydestinationaccount.blob.core.chinacloudapi.cn/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Container example

azcopy copy 'https://mysourceaccount.blob.core.chinacloudapi.cn/mycontainer' 'https://mydestinationaccount.blob.core.chinacloudapi.cn/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

Account example

azcopy copy 'https://mysourceaccount.blob.core.chinacloudapi.cn/' 'https://mydestinationaccount.blob.core.chinacloudapi.cn' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

The copy operation is synchronous. All files have been copied when the command returns.

Copy with optional flags

You can tweak your copy operation by using optional flags. Here's a few examples.

Scenario	Flag
Copy blobs as Block, Page, or Append Blobs.	--blob-type=[BlockBlob|PageBlob|AppendBlob]
Copy to a specific access tier (such as the archive tier).	--block-blob-tier=[None|Hot|Cool|Archive]
Automatically decompress files.	--decompress=[gzip|deflate]

For a complete list, see options.

Next steps

Find more examples in these articles:

• Examples: Upload
• Examples: Download
• Examples: Synchronize
• Examples: Amazon S3 buckets
• Examples: Google Cloud Storage
• Examples: Azure Files
• Tutorial: Migrate on-premises data to cloud storage by using AzCopy

See these articles to configure settings, optimize performance, and troubleshoot issues:

• AzCopy configuration settings
• Optimize the performance of AzCopy
• Find errors and resume jobs by using log and plan files in AzCopy
• Troubleshoot problems with AzCopy v10