文档

Topic管理

更新时间:
一键部署
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

Topic是云消息队列 RocketMQ 版里对消息的一级归类。云消息队列 RocketMQ 版支持发布和订阅模型,通过Topic完成消息的发布和订阅。消息生产者将消息发送到Topic中,而消息消费者则通过订阅该Topic来消费消息。本文介绍如何在云消息队列 RocketMQ 版控制台上创建、删除、更新和查询Topic。

注意事项

  • Topic不能跨实例使用,例如在实例A中创建的Topic A不能在实例B中使用。

  • Topic类型和消息类型必须一致不能混用。例如,您需要创建一个Topic用于收发普通消息,则该Topic的消息类型必须为普通消息类型,不能选择顺序消息、事务消息等,否则会导致消息收发失败。

计费说明

云消息队列 RocketMQ 版会对已创建的每一个Topic收取Topic资源占用费,即使Topic未使用也会产生费用,建议您及时删除不需要使用的Topic。更多计费信息,请参见消息收发定价详情企业铂金版计费说明

Topic命名规范

  • Topic名称长度限制为3~64个字符,只能包含英文、数字、短划线(-)以及下划线(_)。

  • 如果Topic所在的实例有命名空间,则Topic的名称需要保证实例内唯一,不能和本实例下已有的Topic名称或Group ID重复;跨实例之间可以重名,例如实例A的Topic名称可以和实例B的Topic名称重复,也可以和实例B的Group ID重复。

  • 如果Topic所在的实例无命名空间,则Topic的名称需要保证跨实例和跨地域全局唯一,全局范围内不能和已有的Topic名称或Group ID重复。

说明

实例是否有命名空间,可以在云消息队列 RocketMQ 版控制台实例详情页面的基础信息区域查看。

创建Topic

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

  2. 在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。

  3. 在左侧导航栏,单击Topic 管理,然后在页面左上角单击创建 Topic

  4. 创建 Topic面板中,输入该Topic的名称描述,选择该Topic的消息类型,然后单击确定

    重要

    Topic的消息类型不能混用,例如您创建的Topic的消息类型为普通消息,则该Topic只能收发普通消息,不能用来收发顺序消息。更多信息,请参见消息类型列表

    创建Topic

删除Topic

警告

Topic删除后,相关的生产者、消费者将会立即停止服务,Topic元数据和Topic的消息数据也会被同时删除且不可恢复,请您谨慎执行该操作。

  1. 实例列表页面单击目标实例名称,然后在左侧导航栏,单击Topic 管理

  2. 在Topic列表中找到您需要删除的Topic,在其操作列单击更多,然后在弹出的下拉菜单中选择删除

  3. 在弹出的对话框中单击确认

更新Topic

  1. 实例列表页面单击目标实例名称,然后在左侧导航栏,单击Topic 管理

  2. 在Topic列表中找到您需要更新的Topic,在其操作列单击详情,进入Topic 详情页面。

  3. 基础信息区域中,单击Topic 描述后的编辑,在文本框中输入修改后的Topic描述,并单击确定完成修改。更新Topic

查询Topic

  1. 实例列表页面单击目标实例名称,然后在左侧导航栏,单击Topic 管理

  2. 在Topic列表中单击您需要查询的Topic的名称或在其操作列单击详情

相关文档

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