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

az storage blob directory metadata

注意

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

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

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

管理目录元数据。

命令

名称	说明	类型	状态
az storage blob directory metadata show	显示指定 Blob 目录的所有用户定义的元数据。	分机	预览和弃用
az storage blob directory metadata update	将指定 Blob 目录的用户定义元数据设置为一个或多个名称值对。	分机	预览和弃用

az storage blob directory metadata show

预览 已放弃

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

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

显示指定 Blob 目录的所有用户定义的元数据。

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

示例

显示指定 Blob 目录的所有用户定义的元数据。

az storage blob directory metadata 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。

--cpk

使用给定密钥解密服务端的数据。 必须使用 HTTPS 使用客户提供的密钥。 由于加密密钥本身在请求中提供，因此必须建立安全连接才能传输密钥。

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--lease-id

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

--sas-token

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

--snapshot

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

--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 metadata update

预览 已放弃

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

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

将指定 Blob 目录的用户定义元数据设置为一个或多个名称值对。

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

示例

将指定 Blob 目录的用户定义元数据设置为一个或多个名称值对。

az storage blob directory metadata update --metadata tag1=value1 -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。

--cpk

使用给定密钥加密服务端的数据。 必须使用 HTTPS 使用客户提供的密钥。 由于加密密钥本身在请求中提供，因此必须建立安全连接才能传输密钥。

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--lease-id

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

--metadata

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

--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 获取完整的调试日志。