标签可以识别资源,您可以将作用相同的云消息队列 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的标签操作类似,本文以实例为例,介绍如何为实例添加标签。
登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表。
- 在顶部菜单栏,选择地域,如华东1(杭州)。在该地域的所有实例都展示在实例列表页面。
在实例列表页面,找到您想要添加标签的实例,在其标签列,将光标移动至图标,在弹出的消息框中,单击+ 添加。
在编辑标签面板,按要求输入标签键和标签值,然后单击确定。
标签列的浅灰色的图标变为深灰色的图标,则说明标签已被成功添加。
根据标签过滤资源
实例、Topic和Group的标签操作类似,本文以实例为例,介绍如何通过标签过滤实例列表。
在实例列表页面,单击标签选择。
分别在标签键和标签值下的列表中选择对应的值,然后单击搜索。
列表中将只显示绑定了对应标签的实例。
编辑和删除标签
实例、Topic和Group的标签操作类似,本文以实例为例,介绍如何为实例修改或删除标签。
在实例列表页面,找到您想要编辑或删除标签的实例,在其标签列,将光标放至图标,在弹出的消息框中,单击编辑。
在编辑标签面板,按需执行相应操作:
编辑标签:修改标签键和标签值输入框中的取值,或在新的一行中输入新的标签键值对,然后单击确定。
删除标签:在您需删除的标签键值对右侧,单击图标,然后单击确定。
相关文档
实例标签也可用于账单分账,更多信息,请参见分账规则及最佳实践。
标签的相关操作也可以通过调用API完成:
绑定标签:TagResources
查询标签:ListTagResources
解绑并删除标签:UntagResources