Skip to content
GitHub Action edited this page Feb 18, 2026 · 69 revisions

azcopy

AzCopy is a command line tool that moves data into and out of Azure Storage.

Synopsis

AzCopy 10.32.1 Project URL: github.com/Azure/azure-storage-azcopy

AzCopy is a command line tool that moves data into and out of Azure Storage. To report issues or to learn more about the tool, go to github.com/Azure/azure-storage-azcopy.

The general format of the commands is: 'azcopy [command] [arguments] --[flag-name]=[flag-value]'.

Usage

azcopy [flags]

Options

Flag Type Default Description
--await-continue bool false Used when debugging, to tell AzCopy to await continue on stdin before starting any work. Assists with debugging AzCopy via attach-to-process
--await-open bool false Used when debugging, to tell AzCopy to await open on stdin, after scanning but before opening the first file. Assists with testing cases around file modifications between scanning and usage
--cap-mbps float64 0 Caps the transfer rate, in megabits per second. Moment-by-moment throughput might vary slightly from the cap. If this option is set to zero, or it is omitted, the throughput isn't capped.
--check-version bool false Check if a newer AzCopy version is available.
--debug-skip-files string `` Used when debugging, to tell AzCopy to cancel the job midway. List of relative paths to skip in the STE.
--log-level string INFO Define the log verbosity for the log file, available levels: DEBUG(detailed trace), INFO(all requests/responses), WARNING(slow responses), ERROR(only failed requests), and NONE(no output logs). (default 'INFO').
--output-level string default Define the output verbosity. Available levels: essential, quiet.
--output-type string text Format of the command's output. The choices include: text, json. The default value is 'text'.
--trusted-microsoft-suffixes string `` Specifies additional domain suffixes where Azure Active Directory login tokens may be sent. The default is '.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net'. Any listed here are added to the default. For security, you should only put Microsoft Azure domains here. Separate multiple entries with semi-colons.

Subcommands

Command Description
azcopy bench Performs a performance benchmark
azcopy completion Generate the autocompletion script for the specified shell
azcopy copy Copies source data to a destination location
azcopy doc Generates documentation for the tool in Markdown format
azcopy env Shows the environment variables that you can use to configure the behavior of AzCopy.
azcopy help Help about any command
azcopy jobs Sub-commands related to managing jobs
azcopy list List the entities in a given resource
azcopy login Log in to Microsoft Entra ID to access Azure Storage resources.
azcopy logout Log out to terminate access to Azure Storage resources.
azcopy make Create a container or file share.
azcopy remove Delete blobs or files from an Azure storage account
azcopy set-properties Given a location, change all the valid system properties of that storage (blob or file)
azcopy sync Replicate source to the destination location

Clone this wiki locally