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

az storage blob tag

注意

此参考是 Azure CLI(版本 2.27.0 或更高版本)的 storage-blob-preview 扩展的一部分。 该扩展将在首次运行 az storage blob tag 命令时自动安装。 详细了解扩展。

此命令组处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

管理 Blob 标记。

命令

名称 说明 类型 状态
az storage blob tag list

获取 blob 或特定 Blob 版本的标记,或快照。

扩展 预览
az storage blob tag set

在 blob 或特定 blob 版本上设置标记,但不快照。

分机 预览

az storage blob tag list

预览

命令组“存储 blob 标记”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

获取 blob 或特定 Blob 版本的标记,或快照。

az storage blob tag list [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--sas-token]
                         [--snapshot]
                         [--tags-condition]
                         [--timeout]
                         [--version-id]

可选参数

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

容器名称。

--name -n

Blob 名称。

--sas-token

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

--snapshot

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

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--timeout

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

--version-id

可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。

全局参数
--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 tag set

预览

命令组“存储 blob 标记”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

在 blob 或特定 blob 版本上设置标记,但不快照。

每次调用此操作都会替换附加到 Blob 的所有现有标记。 若要从 Blob 中删除所有标记,请调用未设置标记的此操作。

az storage blob tag set --tags
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--blob-url]
                        [--connection-string]
                        [--container-name]
                        [--name]
                        [--sas-token]
                        [--tags-condition]
                        [--timeout]
                        [--version-id]

必需参数

--tags
预览

空格分隔标记:key[=value] [key[=value] ...]。标记区分大小写。 标记集最多可以包含 10 个标记。 标记键必须介于 1 到 128 个字符之间,标记值必须介于 0 到 256 个字符之间。 有效的标记键和值字符包括:小写字母和大写字母、数字(0-9)、空格( )、加(+)、减号(-)、句点(.)、solidus(/)、冒号(:)、等号(=)、下划线(_)。

可选参数

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

容器名称。

--name -n

Blob 名称。

--sas-token

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

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--timeout

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

--version-id

可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。

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