# 配置RocketMQ实例标签
标签是RocketMQ实例的标识，为RocketMQ实例添加标签，可以方便用户识别和管理拥有的RocketMQ实例资源。
您可以在创建RocketMQ实例时添加标签，也可以在RocketMQ实例创建完成后，在"标签"页面添加标签。另外，您还可以删除不再使用的标签。
如您的组织已经设定分布式消息服务RocketMQ版的相关标签策略，则需按照标签策略规则为RocketMQ实例添加标签。在"标签"页面新添加的标签如果不符合标签策略的规则，会添加失败。
标签共由两部分组成："标签键"和"标签值"，其中，"标签键"和"标签值"的命名规则如[表1]所示。
 表1标签命名规则 
| 参数名称 | 规则                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|
| 标签键  | - 不能为空。  - 对于同一个实例，Key值唯一。  - 长度为1\~128个字符（中文也可以输入128个字符）。  - 由任意语种字母、数字、空格和字符组成，字符仅支持_ . : = + - @  - 首尾字符不能为空格。  - 不能以_sys_开头。   |
| 标签值  | - 长度为0\~255个字符（中文也可以输入255个字符）。  - 由任意语种字母、数字、空格和字符组成，字符仅支持_ . : / = + - @                                                                                                                                                                                                                                                                                               |
   
#### 约束与限制
最多支持添加20个不同的标签。
#### 前提条件
已购买RocketMQ实例。
#### 配置RocketMQ实例标签
1. 登录[RocketMQ实例控制台](https://console.huaweicloud.com/dms/?engine=reliability&locale=zh-cn#/queue/manager/instances)。
2. 通过以下任意一种方法，进入"编辑标签"页面配置RocketMQ实例标签。 
   - 在待编辑标签的实例所在行，单击"更多 \> 编辑标签"。
   
   - 单击RocketMQ实例的名称，进入实例概览页面。在左侧导航栏单击"实例管理 \> 标签"，单击"编辑标签"。
   
   - 单击待编辑标签的RocketMQ实例名称，进入实例概览页面。在页面右上角，单击"![](https://support.huaweicloud.com/usermanual-hrm/zh-cn_image_0000002435187988.png) \> 编辑标签"。
   
   
   
   
3. 您可以根据实际需要，添加/删除/编辑标签。 
   表2标签操作说明 
   | 操作类型 | 操作步骤                                                                                                                                                                                                                                                                                                                                                              |
   |:---|:---|
   | 添加标签  | 1. 单击"添加标签"，在"标签键"和"标签值"中，输入标签的键/值。如果您已经预定义了标签，在"标签键"和"标签值"中选择已经定义的标签键/值。 最多可以添加**20个标签**。   2. 单击"确定"，成功为实例添加标签。 在实例的"编辑标签"页面或标签列表页面，查看新添加的标签。    |
   | 编辑标签 | 修改标签键/值，单击"确定"，完成标签的修改。 在实例的"编辑标签"页面或标签列表页面，查看修改后的标签键/值。                                                                                                                                                                                                                                                                           |
   | 删除标签 | 在待删除的标签所在行，单击"删除"。然后单击"确定"，完成标签的删除。 已删除的标签不再显示在实例的"编辑标签"页面和标签列表中，表明标签已成功删除。                                                                                                                                                                                                                                                         |
      
   
   
 
#### 根据标签过滤实例
1. 登录[RocketMQ实例控制台](https://console.huaweicloud.com/dms/?engine=reliability&locale=zh-cn#/queue/manager/instances)。
2. 在实例列表页面，单击搜索框，选择标签键、运算符和标签值。 
   运算符包含等于、不等于、包含和不包含，您可根据所选运算符设置精确或模糊查找。
   列表中将只显示配置了对应标签的实例。
   图1根据定义好的标签查询指定实例   
   ![](https://support.huaweicloud.com/usermanual-hrm/zh-cn_image_0000002447672977.png "点击放大")
   
   
 
#### 相关文档
- 添加和删除标签也可以通过调用API完成，具体请参见[批量添加或删除实例标签](https://support.huaweicloud.com/api-hrm/BatchCreateOrDeleteRocketmqTag.html)。
- 设置标签后，您可以在实例列表页面通过标签查询对应的实例信息，具体请参见[查看RocketMQ实例基本信息](https://support.huaweicloud.com/usermanual-hrm/hrm-ug-004.html#section1)。