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

az tag

  • 参考

对资源进行标记管理。

命令

名称 说明 类型 状态
az tag add-value

创建标记值。

 核心 GA
az tag create

在特定资源上创建标记。

 核心 GA
az tag delete

删除特定资源上的标记。

 核心 GA
az tag list

列出特定资源上的整个标记集。

 核心 GA
az tag remove-value

删除预定义标记名称的预定义标记值。

 核心 GA
az tag update

选择性地更新特定资源上的标记集。

 核心 GA

az tag add-value

编辑

创建标记值。

az tag add-value --name
                 --value

示例

创建标记值。

az tag add-value --name MyTag --value MyValue

必需参数

--name -n

标记名称。

--value

标记值。

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

编辑

在特定资源上创建标记。

具有 id 的 az tag create 命令在资源、资源组或订阅上创建或更新整个标记集。 此操作允许在指定的资源、资源组或订阅上添加或替换整个标记集。 指定的实体最多可以有 50 个标记。 请注意：“tag create”的行为类似于“tag init”，因此使用此命令创建的标记是执行后唯一存在的标记。

az tag create [--name]
              [--resource-id]
              [--tags]

示例

在订阅中创建标记。

az tag create --name MyTag

在订阅上创建或更新整个标记集。

az tag create --resource-id /subscriptions/{subId} --tags Dept=Finance Status=Normal

在资源组上创建或更新整个标记集。

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --tags Dept=Finance Status=Normal

在资源上创建或更新整个标记集。

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --tags Dept=Finance Status=Normal

可选参数

--name -n

要创建的标记的名称。

--resource-id

要标记的实体的资源标识符。 可以标记资源、资源组或订阅。

--tags

要应用于资源的标记。

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

编辑

删除特定资源上的标记。

id 的 az tag delete 命令将删除资源、资源组或订阅上的整个标记集。

az tag delete [--name]
              [--resource-id]
              [--yes]

示例

从未与资源关联的订阅中删除预定义标记，或者没有标记值。

az tag delete --name MyTag

删除订阅上的整个标记集。

az tag delete --resource-id /subscriptions/{sub-id}

删除资源组上的整个标记集。

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

删除资源上的整个标记集。 （即使使用 --name 和 --resource-id 指定单个标记）

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

可选参数

--name -n

要删除的标记的名称。

--resource-id

要标记的实体的资源标识符。 可以标记资源、资源组或订阅。

--yes -y

不提示确认。

默认值: False
全局参数
--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 tag list

编辑

列出特定资源上的整个标记集。

ID 的 az tag list 命令列出资源、资源组或订阅上的整个标记集。

az tag list [--resource-id]

示例

列出订阅上的整个标记集。

az tag list --resource-id /subscriptions/{sub-id}

列出资源组上的整个标记集。

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

列出资源上的整个标记集。

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

可选参数

--resource-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 tag remove-value

编辑

删除预定义标记名称的预定义标记值。

此操作允许从现有预定义标记名称的预定义值列表中删除值。 删除的值不得用作任何资源的给定标记名称的标记值。

az tag remove-value --name
                    --value

必需参数

--name -n

标记名称。

--value

标记值。

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

编辑

选择性地更新特定资源上的标记集。

具有 ID 的 az tag update 命令有选择地更新资源、资源组或订阅上的标记集。 此操作允许替换、合并或选择性地删除指定资源、资源组或订阅上的标记。 指定的实体在操作结束时最多可以有 50 个标记。 “replace”选项将整个现有标记集替换为一个新集。 “merge”选项允许使用新名称添加标记，并使用现有名称更新标记的值。 “delete”选项允许根据给定的名称或名称/值对选择性地删除标记。

az tag update --operation {Delete, Merge, Replace}
              --resource-id
              --tags

示例

选择性地使用“合并”操作更新订阅上的标记集。

az tag update --resource-id /subscriptions/{sub-id} --operation merge --tags key1=value1 key3=value3

选择性地使用“替换”操作更新资源组上的标记集。

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --operation replace --tags key1=value1 key3=value3

选择性地使用“删除”操作更新资源上的标记集。

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --operation delete --tags key1=value1

必需参数

--operation

更新操作。 选项包括合并、替换和删除。

接受的值: Delete, Merge, Replace
--resource-id

要标记的实体的资源标识符。 可以标记资源、资源组或订阅。

--tags

要对资源进行更新的标记。

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