Skip to content

azcopy_list

Jump to bottom
GitHub Action edited this page Feb 4, 2026 · 58 revisions

azcopy list

List the entities in a given resource

Synopsis

This command lists accounts, containers, and directories. Blob Storage, Azure Data Lake Storage, and File Storage are supported. Microsoft Entra ID authorization for Files is currently not supported; please use SAS to authenticate for Files.

Usage

azcopy list [containerURL]

Examples

azcopy list [containerURL] --properties [semicolon(;) separated list of attributes (LastModifiedTime, VersionId, BlobType, BlobAccessTier, ContentType, ContentEncoding, ContentMD5, LeaseState, LeaseDuration, LeaseStatus) enclosed in double quotes (")]

Options

Flag Type Default Description
--location string `` Optionally specifies the location. For Example: Blob, File, BlobFS
--machine-readable bool false False by default. Lists file sizes in bytes.
--mega-units bool false False by default. Displays units in orders of 1000, not 1024.
--properties string `` Properties to be displayed in list output. Possible properties include: LastModifiedTime, VersionId, BlobType, BlobAccessTier, ContentType, ContentEncoding, ContentMD5, LeaseState, LeaseDuration, LeaseStatus, ArchiveStatus. Delimiter (;) should be used to separate multiple values of properties (i.e. 'LastModifiedTime;VersionId;BlobType').
--running-tally bool false False by default. Counts the total number of files and their sizes.
--trailing-dot string `` 'Enable' by default to treat file share related operations in a safe manner. Available options: Enable, Disable, AllowToUnsafeDestination. Choose 'Disable' to go back to legacy (potentially unsafe) treatment of trailing dot files where the file service will trim any trailing dots in paths. This can result in potential data corruption if the transfer contains two paths that differ only by a trailing dot (ex: mypath and mypath.). If this flag is set to 'Disable' and AzCopy encounters a trailing dot file, it will warn customers in the scanning log but will not attempt to abort the operation. If the destination does not support trailing dot files (Windows or Blob Storage), AzCopy will fail if the trailing dot file is the root of the transfer and skip any trailing dot paths encountered during enumeration.

Global Options

These options are inherited from parent commands.

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.

Parent command: azcopy

Clone this wiki locally