概述

标签用于标识资源，可以帮助您从不同维度（例如用途、类型、所有者或环境等）对具有相同特征的资源进行标记和分类，便于搜索和聚合，从而轻松管理云上资源。

应用场景

• 分组管理
  您可以给不同的环境（如生产环境和测试环境）、操作系统（如Windows和Linux）或者客户端平台（如iOS和Android）添加不同的标签。例如，为测试环境涉及的所有实例添加一个类似Test:Server-Windows的标签键值对，在日常维护中能从众多实例中先筛选出一组带该标签的实例再进行操作。
• 标签分账
  在团队或者项目管理中，您可以添加以群组、项目或部门为维度的标签（如CostCenter:Project），然后实现分组，在费用中心基于标签实现分账管理。当您使用标签进行分账时，需要在费用中心控制台的“账单管理-费用标签”处启用费用标签，将对应标签运用到账单明细中，详细操作请参见费用标签。

标签类型

• 系统标签：创建资源时系统自动为资源添加的标签为系统标签，一般以volc:开头，系统标签仅支持查看，不支持编辑。
• 用户标签：您手动为资源添加的标签均为用户标签，不能添加以volc:开头包括任意大小写形式的用户标签。
• 标签设计原则请参见标签设计原则。

标签使用说明

• 标签由标签键（Key）和标签值（Value）组成，设置标签键（Key）、标签值（Value）时需区分英文大小写，标签值（Value）可为空。
• 同一实例多个标签的标签键（Key）不可重复，且每个标签键（Key）只能存在一个标签值（Value）。
• 单次操作最多可添加20个标签，单个VPC资源最多可添加50个标签。

操作步骤

添加标签

创建资源时添加标签

创建时，选择或输入标签键和标签值，添加标签。

创建资源后添加标签

1. 登录私有网络资源控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 单击目标资源的名称，单击标签后的 图标。
4. 单击 图标，为资源添加新标签。
5. 选择或输入新标签的标签键和标签值。
6. 单击“确定”按钮，完成操作。

编辑标签

1. 登录私有网络资源控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 单击目标资源的名称，单击标签后的 图标。
4. 编辑标签。
   • 添加标签：在弹出的“编辑标签”对话框中，添加新的标签键（Key）和标签值（Value）。
   • 修改标签：在弹出的“编辑标签”对话框中，直接在待修改标签的标签键（Key）、标签值（Value）上进行修改即可。
   • 删除标签：单击目标标签右侧的 图标。
5. 单击“确定”按钮，完成操作。

通过标签搜索资源

操作说明

• 支持同时搜索多个标签，单次最多可添加10个标签。
• 如果搜索条件中有多个标签，多个标签的标签键（Key）之间的关系为逻辑“与（AND）”；如果同一个标签键（Key）有多个标签值（Value），多个标签值（Value）之间的关系为逻辑“或（OR）”。
• 搜索时标签值（Value）可不填或为空值，不填则默认对标签值（Value）不作限制，填入空值则搜索标签值（Value）为空的标签。
• 搜索时同一个标签键（Key）可同时添加多个标签值（Value），最多支持添加3个。

  说明

  因为不同的云资源实例标签的标签键（Key）的值可以相同，因此在搜索时会出现同一个标签键（Key）添加多个标签值（Value）的情形。

操作示例

按照“标签”维度搜索云资源实例，假设搜索条件为：
标签一：标签键（Key）=key1，标签值（Value）=value1、标签值（Value）=value2。
标签二：标签键（Key）=key2，不设置标签值（Value）。

搜索出的云资源实例应满足以下全部条件：

• 同时具备key1、key2两个标签键（Key）。
• 标签键（Key）是key1的标签，标签值（Value）可以是value1也可以是value2。
• 标签键（Key）是key2的标签，标签值（Value）可以是任意。

操作步骤

1. 登录私有网络资源控制台。
2. 在顶部导航栏，选择目标项目和地域。
3. 单击资源列表中“标签”列的 图标。
4. 选择或输入标签的标签键、标签值。

   说明

   • 最多可同时设置10个标签键进行搜索，每个标签键最多可同时设置3个标签值。
   • 查询指定的多个标签键之间为逻辑“与”的关系，同一标签键的多个标签值之间为逻辑“或”的关系。
5. 单击“确定”按钮，搜索目标资源。

相关文档

• TagResources：为资源添加用户标签。
• UntagResources：为资源解绑用户标签。
• ListTagsForResources：查询满足指定条件的标签信息。