你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az storage azcopy blob

  • 预览
  • 参考

注意

此参考是 Azure CLI（版本 2.50.0 或更高版本）的存储预览扩展的一部分。 该扩展将在首次运行 az storage azcopy blob 命令时自动安装。 详细了解扩展。

命令组“az storage”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

使用 AzCopy 管理非结构化数据（blobs）的对象存储。

命令

名称 说明 类型 状态
az storage azcopy blob delete

使用 AzCopy 从存储 Blob 容器中删除 Blob。

 扩展 预览版
az storage azcopy blob download

使用 AzCopy 从存储 Blob 容器下载 Blob。

 分机 预览
az storage azcopy blob sync

使用 AzCopy 以递归方式将 blob 同步到存储 Blob 容器。

 分机 预览
az storage azcopy blob upload

使用 AzCopy 将 blob 上传到存储 Blob 容器。

 扩展 预览

az storage azcopy blob delete

预览

命令组“az storage”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

使用 AzCopy 从存储 Blob 容器中删除 Blob。

az storage azcopy blob delete --container
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--recursive]
                              [--sas-token]
                              [--target]

示例

从容器中删除单个 Blob。

az storage azcopy blob delete -c MyContainer --account-name MyStorageAccount -t TargetBlob

从容器中删除所有 Blob。

az storage azcopy blob delete -c MyContainer --account-name MyStorageAccount --recursive

删除虚拟目录中的所有 Blob。

az storage azcopy blob delete -c MyContainer --account-name MyStorageAccount -t "path/to/virtual_directory" --recursive

必需参数

--container -c

删除目标容器。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

--recursive -r

以递归方式删除 Blob。

--sas-token

共享访问签名（SAS）。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

--target -t

删除目标路径。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage azcopy blob download

预览

命令组“az storage”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

使用 AzCopy 从存储 Blob 容器下载 Blob。

az storage azcopy blob download --container
                                --destination
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--connection-string]
                                [--recursive]
                                [--sas-token]
                                [--source]

示例

从容器下载单个 Blob。

az storage azcopy blob download -c MyContainer --account-name MyStorageAccount -s "path/to/blob" -d "path/to/file"

从容器下载虚拟目录。

az storage azcopy blob download -c MyContainer --account-name MyStorageAccount -s "path/to/virtual_directory" -d "download/path" --recursive

将容器的内容下载到本地文件系统。

az storage azcopy blob download -c MyContainer --account-name MyStorageAccount -s * -d "download/path" --recursive

必需参数

--container -c

下载源容器。

--destination -d

要下载到的目标文件路径。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

--recursive -r

以递归方式下载 Blob。

--sas-token

共享访问签名（SAS）。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

--source -s

下载源路径。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage azcopy blob sync

预览

命令组“az storage”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

使用 AzCopy 以递归方式将 blob 同步到存储 Blob 容器。

若要了解有关 azcopy sync 的详细信息，请参阅 https://docs.microsoft.com/azure/storage/common/storage-ref-azcopy-sync。

az storage azcopy blob sync --container
                            --source
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--connection-string]
                            [--destination]
                            [--sas-token]

示例

将单个 Blob 同步到容器。

az storage azcopy blob sync -c MyContainer --account-name MyStorageAccount -s "path/to/file" -d NewBlob

将目录同步到容器。

az storage azcopy blob sync -c MyContainer --account-name MyStorageAccount -s "path/to/directory"

必需参数

--container -c

同步目标容器。

--source -s

要从中同步的源文件路径。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

--destination -d

同步目标路径。

--sas-token

共享访问签名（SAS）。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage azcopy blob upload

预览

命令组“az storage”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

使用 AzCopy 将 blob 上传到存储 Blob 容器。

az storage azcopy blob upload --container
                              --source
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--destination]
                              [--recursive]
                              [--sas-token]

示例

将单个 Blob 上传到容器。

az storage azcopy blob upload -c MyContainer --account-name MyStorageAccount -s "path/to/file" -d NewBlob

将目录上传到容器。

az storage azcopy blob upload -c MyContainer --account-name MyStorageAccount -s "path/to/directory" --recursive

将目录的内容上传到容器。

az storage azcopy blob upload -c MyContainer --account-name MyStorageAccount -s "path/to/directory/*" --recursive

必需参数

--container -c

上传目标容器。

--source -s

要从中上传的源文件路径。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

--destination -d

上传目标路径。

--recursive -r

以递归方式上传 Blob。

--sas-token

共享访问签名（SAS）。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。