Skip to content

azcopy_list

Jump to bottom
GitHub Action edited this page Oct 7, 2025 · 53 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.

azcopy list [containerURL] [flags]

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

  -h, --help                  help for list
      --location string       Optionally specifies the location. For Example: Blob, File, BlobFS
      --machine-readable      False by default. Lists file sizes in bytes.
      --mega-units            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         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.

Options inherited from parent commands

      --await-continue continue             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 open                     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 float                      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                       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                    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'). (default "INFO")
      --output-level string                 Define the output verbosity. Available levels: essential, quiet. (default "default")
      --output-type string                  Format of the command's output. The choices include: text, json. 
                                             The default value is 'text'. (default "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.

SEE ALSO

  • azcopy - AzCopy is a command line tool that moves data into and out of Azure Storage.
Auto generated by spf13/cobra on 7-Oct-2025
Clone this wiki locally