标签可以识别资源,您可以将作用相同的消息队列 RocketMQ 版的资源归类,便于搜索和资源聚合。消息队列 RocketMQ 版支持为实例、Topic 和 Group 添加、编辑和删除标签。本文介绍标签的使用说明和使用限制。

使用说明

  • 标签都由一对键值对(Key-Value)组成。
  • 资源的任一标签的标签键(Key)必须唯一。

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

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

使用限制

  • 键(Key)的最大长度:64 个 Unicode 字符,区分大小写。
  • 值(Value)的最大长度:64 个 Unicode 字符,区分大小写。
  • 每个资源的最大标签数为 20。
  • 键(Key)不支持 aliyun、acs: 开头,不允许包含 http:// 和 https://,不允许为空字符串。
  • 值(Value)不允许包含 http:// 和 https://,不允许为空字符串。
  • 每个地域中的标签信息不互通。例如在华东 1(杭州)地域创建的标签在华东 2(上海)地域不可见。

控制台操作

如果您需通过消息队列 RocketMQ 版控制台执行标签管理相关操作,请参见以下文档:

相关 OpenAPI

如果您需通过调用 OpenAPI 实现对标签的管理,请参见以下文档: