标签管理

标签可以识别资源,您可以将作用相同的云消息队列 RocketMQ 版的资源通过标签进行归类,便于搜索和资源聚合。云消息队列 RocketMQ 版支持为实例、Topic和Group添加标签,并支持修改和删除标签。本文介绍标签的应用场景、使用说明、使用限制以及标签的相关操作。

应用场景

随着您创建的云消息队列 RocketMQ 版资源的增加,管理难度也随之增加。除了通过资源名称进行标识和区分外,您还可以通过标签将资源按照业务、用途、使用对象等不同维度进行划分,为资源绑定标签后,可快速通过标签查询并过滤指定类型的资源。

如下图所示,若未设置标签,则以下Topic资源只能通过Topic名称进行管理和识别,随着业务增加,Topic数量越来越多,管理也会越来越困难。您可以根据业务场景,将Topic进行分类,给相同业务场景的Topic设置同样的标签,设置完成后,您可以根据设置的标签键和标签值查询任一场景的Topic,以便您快速筛选和管理Topic资源。标签管理

使用说明

  • 标签都由一对键值对(Key-Value)组成。

  • 资源的任一标签的标签键(Key)必须唯一。

    例如,云消息队列 RocketMQ 版实例先添加了city:shanghai标签,后续如需添加city:shenzhen标签,需先删除city:shanghai标签。

  • 您可以参见标签最佳实践了解设计标签键值的建议。

使用限制

  • 键(Key)的最大长度:64个Unicode字符,区分大小写。

  • 值(Value)的最大长度:64个Unicode字符,区分大小写。

  • 每个资源的最大标签数为20。

  • 键(Key)不支持aliyun、acs:开头,不允许包含http://和https://,不允许为空字符串。

  • 值(Value)不允许包含http://和https://,允许为空字符串。

  • 每个地域中的标签信息不互通。例如在华东1(杭州)地域创建的标签在华东2(上海)地域不可见。

添加标签

说明

实例、Topic和Group的标签操作类似,本文以实例为例,介绍如何为实例添加标签。

  1. 登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表

  2. 在顶部菜单栏,选择地域,如华东1(杭州)
    在该地域的所有实例都展示在实例列表页面。
  3. 实例列表页面,找到您想要添加标签的实例,在其标签列,将光标移动至tag_icon图标,在弹出的消息框中,单击+ 添加

    实例标签

  4. 在编辑标签面板,按要求输入标签键标签值,然后单击确定

    标签列的浅灰色的tag_icon图标变为深灰色的tag_icon_success图标,则说明标签已被成功添加。

根据标签过滤资源

说明

实例、Topic和Group的标签操作类似,本文以实例为例,介绍如何通过标签过滤实例列表。

  1. 实例列表页面,单击标签选择

    标签选择

  2. 分别在标签键和标签值下的列表中选择对应的值,然后单击搜索

    列表中将只显示绑定了对应标签的实例。过滤结果

编辑和删除标签

说明

实例、Topic和Group的标签操作类似,本文以实例为例,介绍如何为实例修改或删除标签。

  1. 实例列表页面,找到您想要编辑或删除标签的实例,在其标签列,将光标放至tag_icon_success图标,在弹出的消息框中,单击编辑

    编辑标签

  2. 在编辑标签面板,按需执行相应操作:

    • 编辑标签:修改标签键标签值输入框中的取值,或在新的一行中输入新的标签键值对,然后单击确定

    • 删除标签:在您需删除的标签键值对右侧,单击tag_delete图标,然后单击确定

相关文档

实例标签也可用于账单分账,更多信息,请参见分账规则及最佳实践

标签的相关操作也可以通过调用API完成: