# 配置Kafka实例标签
标签是Kafka实例的标识，为Kafka实例添加标签，可以方便用户识别和管理拥有的Kafka实例资源。
如您的组织已经设定分布式消息服务Kafka版的相关标签策略，则需按照标签策略规则为Kafka实例添加标签。新添加的标签如果不符合标签策略的规则，会添加失败。
标签共由两部分组成："标签键"和"标签值"，其中，"标签键"和"标签值"的命名规则如[表1]所示。
 表1标签命名规则 
| 参数名称 | 规则                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|
| 标签键  | - 不能为空。  - 对于同一个实例，Key值唯一。  - 长度为1\~128个字符（中文也可以输入128个字符）。  - 由任意语种字母、数字、空格和字符组成，字符仅支持_ . : = + - @  - 首尾字符不能为空格。  - 不能以_sys_开头。   |
| 标签值  | - 长度为0\~255个字符（中文也可以输入255个字符）。  - 由任意语种字母、数字、空格和字符组成，字符仅支持_ . : = + - @                                                                                                                                                                                                                                                                                                                               |
   
#### 约束限制
一个Kafka实例最多添加20个标签。
#### 配置单个Kafka实例标签
1. 登录[Kafka控制台](https://console.huaweicloud.com/dms/?engine=kafka&locale=zh-cn#/queue/manager/newKafkaList)。
2. 在管理控制台左上角单击![](https://support.huaweicloud.com/usermanual-kafka/zh-cn_image_0143929918.png)，选择Kafka实例所在的区域。
3. 通过以下任意一种方法，配置Kafka实例标签。 
   **方法一：**
   1. 单击实例名称，进入实例详情页面。
   
   2. 在左侧导航栏单击"实例管理 \> 标签"，进入标签列表页面。
   
   3. 单击"编辑标签"，弹出"编辑标签"对话框。
   
   4. 您可以根据实际需要，添加/编辑/删除标签。
      表2标签操作说明 
      | 操作类型    | 操作步骤                                                                                                                                                                                                                                                                                                                                                                            |
      |:---|:---|
      | 添加标签   | 1. 单击"添加标签"，在"标签键"和"标签值"中，输入标签的键/值。如果您已经预定义了标签，在"标签键"和"标签值"中选择已经定义的标签键/值。 最多可以添加**20个标签**。   2. 单击"确定"，成功为实例添加标签。 在标签列表页面，查看新添加的标签。    |
      | 编辑标签 | 修改标签键/值，单击"确定"，完成标签的修改。 在标签列表页面，查看修改后的标签键/值。                                                                                                                                                                                                                                                                                                   |
      | 删除标签 | 在待删除的标签所在行，单击"删除"。然后单击"确定"，完成标签的删除。 已删除的标签不再显示在标签列表中，表明标签已成功删除。                                                                                                                                                                                                                                                                                 |
         
      
   
   
   **方法二：**
   1. 在待配置标签的Kafka实例所在行，单击"更多 \> 编辑标签"，弹出"编辑标签"对话框。
   
   2. 您可以根据实际需要，添加/编辑/删除标签。
      表3标签操作说明 
      | 操作类型  | 操作步骤                                                                                                                                                                                                                                                                                                                                                                                                                                                |
      |:---|:---|
      | 添加标签  | 1. 单击"添加标签"，在"标签键"和"标签值"中，输入标签的键/值。如果您已经预定义了标签，在"标签键"和"标签值"中选择已经定义的标签键/值。 最多可以添加**20个标签**。   2. 单击"确定"，成功为实例添加标签。  3. 在已添加标签的Kafka实例所在行，单击"更多 \> 编辑标签"，弹出"编辑标签"对话框。查看新添加的标签。   |
      | 编辑标签 | 1. 修改标签键/值，单击"确定"，完成标签的修改。  2. 在已修改标签的Kafka实例所在行，单击"更多 \> 编辑标签"，弹出"编辑标签"对话框。查看修改后的标签键/值。                                                                                                                                                                                                                          |
      | 删除标签  | 1. 在待删除的标签所在行，单击"删除"。然后单击"确定"，完成标签的删除。  2. 在已删除标签的Kafka实例所在行，单击"更多 \> 编辑标签"，弹出"编辑标签"对话框。已删除的标签不再显示，表明标签已成功删除。                                                                                                                                                                                                       |
         
      
   
   
   
   
 
#### 相关文档
如果您希望通过API添加或删除Kafka实例标签，请参考[批量添加或删除实例标签](https://support.huaweicloud.com/api-kafka/BatchCreateOrDeleteKafkaTag.html)。