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

az storage blob metadata

  • 参考

管理 blob 元数据。

命令

名称 说明 类型 状态
az storage blob metadata show

返回指定 blob 或快照的所有用户定义的元数据。

 核心 GA
az storage blob metadata update

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

 核心 GA

az storage blob metadata show

编辑

返回指定 blob 或快照的所有用户定义的元数据。

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

示例

显示 Blob 的用户定义元数据。

az storage blob metadata show --container-name mycontainer --name myblob

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--blob-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_标准版RVICE_ENDPOINT。

--blob-url

Blob 的完整终结点 URL，包括 SAS 令牌和快照（如果使用）。 这可以是主终结点，也可以是辅助终结点，具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--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 具有活动租约，则为必需。

--name -n

Blob 名称。

--sas-token

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

--snapshot

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

--tags-condition

指定 Blob 标记上的 SQL where 子句，以仅对具有匹配值的 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 metadata update

编辑

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

az storage blob metadata update [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--blob-endpoint]
                                [--blob-url]
                                [--connection-string]
                                [--container-name]
                                [--if-match]
                                [--if-modified-since]
                                [--if-none-match]
                                [--if-unmodified-since]
                                [--lease-id]
                                [--metadata]
                                [--name]
                                [--sas-token]
                                [--snapshot]
                                [--tags-condition]
                                [--timeout]

示例

为 Blob 设置用户定义的元数据。

az storage blob metadata update --container-name mycontainer --name myblob --metadata key=value

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--blob-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_标准版RVICE_ENDPOINT。

--blob-url

Blob 的完整终结点 URL，包括 SAS 令牌和快照（如果使用）。 这可以是主终结点，也可以是辅助终结点，具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

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

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

--name -n

Blob 名称。

--sas-token

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

--snapshot

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

--tags-condition

指定 Blob 标记上的 SQL where 子句，以仅对具有匹配值的 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 获取完整的调试日志。