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

az storage blob directory

注意

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

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

此命令组已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。 有关详细信息，请转到 https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/docs/ADLS%20Gen2.md

管理存储帐户容器中的 Blob 目录。

若要使用目录命令，请确保存储帐户类型存储V2。

命令

名称	说明	类型	状态
az storage blob directory access	管理在启用分层命名空间时目录的访问控制属性。	扩展	预览和弃用
az storage blob directory access set	设置目录的访问控制属性。	扩展	预览和弃用
az storage blob directory access show	显示目录的访问控制属性。	扩展	预览和弃用
az storage blob directory access update	更新目录的访问控制属性。	扩展	预览和弃用
az storage blob directory create	在存储容器中创建存储 Blob 目录。	扩展	预览和弃用
az storage blob directory delete	删除存储容器中的存储 Blob 目录。	扩展	预览和弃用
az storage blob directory download	将 Blob 下载到本地文件路径。	扩展	预览和弃用
az storage blob directory exists	检查存储容器中是否存在 Blob 目录。	扩展	预览和弃用
az storage blob directory list	列出存储目录中的 Blob 和 Blob 子目录。	扩展	预览和弃用
az storage blob directory metadata	管理目录元数据。	扩展	预览和弃用
az storage blob directory metadata show	显示指定 Blob 目录的所有用户定义的元数据。	扩展	预览和弃用
az storage blob directory metadata update	将指定 Blob 目录的用户定义元数据设置为一个或多个名称值对。	扩展	预览和弃用
az storage blob directory move	将存储目录移到存储容器中的另一个存储 Blob 目录。	扩展	预览和弃用
az storage blob directory show	在存储容器中显示存储 Blob 目录属性。	扩展	预览和弃用
az storage blob directory upload	将 Blob 或子目录上传到存储 Blob 目录。	扩展	预览和弃用

az storage blob directory create

预览 已放弃

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

此命令已隐式弃用，因为命令组“存储 blob 目录”已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。

在存储容器中创建存储 Blob 目录。

创建一个存储 Blob 目录，该目录可以包含存储容器中的其他目录或 Blob。

az storage blob directory create --container-name
                                 --directory-path
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--connection-string]
                                 [--lease-id]
                                 [--metadata]
                                 [--permissions]
                                 [--sas-token]
                                 [--timeout]
                                 [--umask]

示例

在存储容器中创建存储 Blob 目录。

az storage blob directory create -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

创建具有权限和 umask 的存储 Blob 目录。

az storage blob directory create -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount --permissions rwxrwxrwx --umask 0000

必需参数

--container-name -c

容器名称。

--directory-path -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。

--lease-id

如果要覆盖的目录具有活动租约，则需要该目录。

--metadata

空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。

--permissions

可选且仅在为帐户启用分层命名空间时才有效。 设置文件所有者、文件拥有组和其他文件的 POSIX 访问权限。 可以向每个类授予读取、写入或执行权限。 粘性位也受支持。 支持符号符号（rwxrw-rw-）和 4 位八进制表示法（例如 0766）。

--sas-token

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

--timeout

请求超时（以秒为单位）。 适用于对服务的每个调用。

--umask

可选且仅在为帐户启用分层命名空间时才有效。 umask 限制文件和目录的权限设置，并且仅在父目录中不存在默认 Acl 时应用。 如果设置了 umask 位，则表示将禁用相应的权限。 这样，生成的权限由 p 和 ^u 提供，其中 p 是权限，而你是 umask。 此处仅支持 4 位八进制表示法（例如 0022）。

默认值: 0027

全局参数

--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 blob directory delete

预览 已放弃

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

此命令已隐式弃用，因为命令组“存储 blob 目录”已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。

删除存储容器中的存储 Blob 目录。

此操作的行为因是否启用分层命名空间而异;如果是，则删除操作可以是原子操作和即时操作;如果不是，则以批处理方式执行该操作，并可以返回继续标记。

az storage blob directory delete --container-name
                                 --directory-path
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--connection-string]
                                 [--fail-not-exist]
                                 [--if-match]
                                 [--if-modified-since]
                                 [--if-none-match]
                                 [--if-unmodified-since]
                                 [--lease-id]
                                 [--marker]
                                 [--recursive]
                                 [--sas-token]
                                 [--timeout]

示例

删除存储容器中的存储 Blob 目录。

az storage blob directory delete -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

必需参数

--container-name -c

容器名称。

--directory-path -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。

--fail-not-exist

指定在目录不存在时是否引发异常。

默认值: False

--if-match

ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值匹配时，才指定此标头来执行该操作。

--if-modified-since

仅当自提供的 UTC 日期时间（Y-m-d'T'H：M'Z'）以来修改时才更改。

--if-none-match

ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值不匹配时，才指定此标头来执行该操作。

--if-unmodified-since

仅当自提供的 UTC 日期时间（Y-m-d'T'H：M'Z'）以来未修改时才更改。

--lease-id

如果目录具有活动租约，则为必需。

--marker

可选。 删除不包含分层命名空间的目录时，使用每个调用删除的路径数受到限制。 如果要删除的路径数超过此限制，则返回继续标记。 返回继续标记时，必须在后续调用删除操作中指定该标记才能继续删除目录。

--recursive

如果为“true”，将删除目录下的所有路径。 如果“false”且目录为非空，则会发生错误。

默认值: False

--sas-token

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

--timeout

请求超时（以秒为单位）。 适用于对服务的每个调用。

全局参数

--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 blob directory download

预览 已放弃

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

此命令已隐式弃用，因为命令组“存储 blob 目录”已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。

将 Blob 下载到本地文件路径。

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

示例

在存储 Blob 目录中下载单个 Blob。

az storage blob directory download -c MyContainer --account-name MyStorageAccount -s "path/to/blob" -d "<local-path>"

下载存储容器中的整个目录。

az storage blob directory download -c MyContainer --account-name MyStorageAccount -s SourceDirectoryPath -d "<local-path>" --recursive

下载存储 Blob 目录的整个子目录。

az storage blob directory download -c MyContainer --account-name MyStorageAccount -s "path/to/subdirectory" -d "<local-path>" --recursive

必需参数

--container -c

下载源容器。

--destination-path -d

要下载的目标本地目录路径。

--source-path -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。

--recursive -r

以递归方式下载 Blob。 如果启用，将下载所有 blob，包括子目录中的 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 获取完整的调试日志。

az storage blob directory exists

预览 已放弃

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

此命令已隐式弃用，因为命令组“存储 blob 目录”已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。

检查存储容器中是否存在 Blob 目录。

az storage blob directory exists --container-name
                                 --directory-path
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--connection-string]
                                 [--sas-token]
                                 [--snapshot]
                                 [--timeout]

示例

检查存储容器中是否存在 Blob 目录。

az storage blob directory exists -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

必需参数

--container-name -c

容器名称。

--directory-path -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。

--sas-token

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

--snapshot

快照参数是一个不透明的 DateTime 值，如果存在，则指定快照。

--timeout

请求超时（以秒为单位）。 适用于对服务的每个调用。

全局参数

--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 blob directory list

预览 已放弃

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

此命令已隐式弃用，因为命令组“存储 blob 目录”已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。

列出存储目录中的 Blob 和 Blob 子目录。

az storage blob directory list --container-name
                               --directory-path
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--delimiter]
                               [--include]
                               [--marker]
                               [--num-results]
                               [--prefix]
                               [--sas-token]
                               [--timeout]

示例

列出存储目录中的 Blob 和 Blob 子目录。

az storage blob directory list -c MyContainer -d DestinationDirectoryPath --account-name MyStorageAccount

必需参数

--container-name -c

容器名称。

--directory-path -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。

--delimiter

当请求包含此参数时，该操作返回结果列表中的一个 ：class：~azure.storage.blob.models.BlobPrefix 元素，该元素充当其名称以相同子字符串开头的所有 blob 的占位符，以分隔符字符的外观开头。 分隔符可以是单个字符或字符串。

--include

指定要包含在响应中的一个或多个其他数据集。

默认值: mc

--marker

不透明的延续标记。 如果指定了num_results并且该生成器已完成枚举结果，则可以从以前的生成器对象的next_marker字段中检索此值。 如果指定，此生成器将从上一个生成器停止的点开始返回结果。

--num-results

指定要返回的最大结果数。 提供“*”以全部返回。

默认值: 5000

--prefix

筛选结果以仅返回名称以指定前缀开头的 blob。

--sas-token

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

--timeout

请求超时（以秒为单位）。 适用于对服务的每个调用。

全局参数

--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 blob directory move

预览 已放弃

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

此命令已隐式弃用，因为命令组“存储 blob 目录”已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。

将存储目录移到存储容器中的另一个存储 Blob 目录。

将存储目录及其所有内容（可以包含其他目录或 blob）移到存储容器中的另一个存储 Blob 目录。 此操作的行为因是否启用分层命名空间而异;如果是，则移动操作为原子操作，且不返回任何标记;如果不是，则以批处理方式执行该操作，并可以返回继续标记。

az storage blob directory move --container-name
                               --destination-path
                               --source-path
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--lease-id]
                               [--move-mode {legacy, posix}]
                               [--sas-token]
                               [--source-if-match]
                               [--source-if-modified-since]
                               [--source-if-none-match]
                               [--source-if-unmodified-since]
                               [--source-lease-id]
                               [--timeout]

示例

将存储目录移到存储容器中的另一个存储 Blob 目录。

az storage blob directory move -c MyContainer -d my-new-directory -s dir --account-name MyStorageAccount

将存储子目录移到存储容器中的另一个存储 Blob 目录。

az storage blob directory move -c MyContainer -d my-new-directory -s dir/subdirectory --account-name MyStorageAccount

必需参数

--container-name -c

容器名称。

--destination-path -d

目标 Blob 目录路径。 它可以是目录或子目录名称，例如 dir、dir/subdir。 如果目标路径存在且为空，则源将移动到目标路径中。 如果目标路径不存在，则会由源创建并覆盖目标路径。 若要控制 nonempty 路径的移动操作，可以使用 --move-mode 来确定其行为。

--source-path -s

源 Blob 目录路径。

可选参数

--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。

--lease-id

目标directory_path的租约 ID。 目标directory_path必须具有活动租约，并且租约 ID 必须匹配。

--move-mode

仅在启用命名空间时才有效。 此参数确定移动操作的行为。 如果目标目录为空，则这两种模式都将覆盖目标目录。 但是，如果目标目录不为空，在旧模式下移动操作将失败，在 posix 模式下，源目录将移动到目标目录中。

接受的值: legacy, posix

默认值: posix

--sas-token

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

--source-if-match

可选。 ETag 值。 仅当源的 ETag 与指定的值匹配时，才指定此标头来执行移动操作。

--source-if-modified-since

可选。 日期和时间值。 仅当源自指定日期和时间以来已修改时，才指定此标头以执行移动操作。

--source-if-none-match

可选。 ETag 值或特殊 wild卡 （“*”） 值。 仅当源的 ETag 与指定的值不匹配时，才指定此标头来执行移动操作。

--source-if-unmodified-since

可选。 日期和时间值。 仅当源自指定日期和时间以来尚未修改时，才指定此标头以执行移动操作。

--source-lease-id

可选。 source_path的租约 ID。 source_path必须具有活动租约，并且租约 ID 必须匹配。

--timeout

请求超时（以秒为单位）。 适用于对服务的每个调用。

全局参数

--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 blob directory show

预览 已放弃

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

此命令已隐式弃用，因为命令组“存储 blob 目录”已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。

在存储容器中显示存储 Blob 目录属性。

az storage blob directory show --container-name
                               --directory-path
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--if-match]
                               [--if-modified-since]
                               [--if-none-match]
                               [--if-unmodified-since]
                               [--lease-id]
                               [--sas-token]
                               [--timeout]

示例

在存储容器中显示存储 Blob 目录属性。

az storage blob directory show -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

必需参数

--container-name -c

容器名称。

--directory-path -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。

--if-match

ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值匹配时，才指定此标头来执行操作。

--if-modified-since

仅当自提供的 UTC 日期时间（Y-m-d'T'H：M'Z'）以来修改时才更改。

--if-none-match

ETag 值或 wild卡 字符 （）。仅当资源的 ETag 与指定的值不匹配时，才指定此标头来执行该操作。指定 wild卡character （） 仅在资源不存在时执行该操作，如果资源不存在，并且操作失败，则它确实存在。

--if-unmodified-since

仅当自提供的 UTC 日期时间（Y-m-d'T'H：M'Z'）以来未修改时才更改。

--lease-id

如果 Blob 具有活动租约，则为必需。

--sas-token

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

--timeout

请求超时（以秒为单位）。 适用于对服务的每个调用。

全局参数

--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 blob directory upload

预览 已放弃

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

此命令已隐式弃用，因为命令组“存储 blob 目录”已弃用，将在将来的版本中删除。 请改用“az storage fs directory”。

将 Blob 或子目录上传到存储 Blob 目录。

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

示例

将单个 Blob 上传到存储 Blob 目录。

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

将本地目录上传到存储 Blob 目录。

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

将本地目录中的一组文件上传到存储 Blob 目录。

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

必需参数

--container -c

上传目标容器。

--destination-path -d

将前面追加到 Blob 名称的目标路径。

--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。

--recursive -r

以递归方式上传 Blob。 如果启用，将上传子目录中包括 Blob 的所有 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 获取完整的调试日志。