标签可以识别资源，您可以将作用相同的消息队列 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 实现对标签的管理，请参见以下文档：