全部产品
Search
文档中心

云消息队列 MQTT 版:数据流出规则管理

更新时间:Aug 12, 2026

如需将云消息队列 MQTT 版的数据导出至其他阿里云产品,您需创建数据流出规则。该规则用于将MQTT客户端发送的消息导出到您配置的其他阿里云产品中,从而实现直接调用云产品的API读取MQTT客户端发送的消息。

流程说明

数据流出

规则限制

限制项

限制值

说明

单实例规则数量

100

如果默认限制不满足,加入钉钉群 35228338 申请提升配额。

规则去重限制

同一个内部资源同种规则只能创建一个规则。

例如一个Group ID只能创建一个上下线通知规则,一个MQTT Topic只能创建一个数据流入规则和一个数据流出规则。

地域限制

不支持跨地域创建规则,规则的数据源和数据目标所属的实例必须处于同一地域。

例如,创建数据流出规则,数据源实例属于华东1(杭州)地域,则数据目标只能选择华东1(杭州)地域的实例。

实例版本

仅新版本的实例支持。

新购的实例默认为新版本实例,旧版实例已不支持购买。

云消息队列 RocketMQ 版实例版本

仅4.0系列实例支持

通过消息流入或消息流出规则进行数据互通时,云消息队列 RocketMQ 版仅4.0系列实例支持,5.0系列实例不支持。

如需与云消息队列 RocketMQ 版 5.x 系列实例进行数据互通,请使用消息集成(Connector)方式:在MQTT 控制台左侧导航栏选择Connector 生态集成,创建消息集成任务。消息集成基于 EventBridge 构建,支持云消息队列 RocketMQ 版 4.x 和 5.x 系列实例。详情请参见集成概述。

创建数据流出规则

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

  2. 在顶部菜单栏选择目标地域,然后在实例列表中单击实例名称进入实例详情页面。

  3. 在左侧导航栏单击规则管理。

  4. 在规则管理页面,单击RocketMQ 规则页签,然后单击创建规则。

  5. 在创建规则页面完成以下操作。

    1. 在配置基本信息配置向导页面,填写规则的基本信息,然后单击下一步。

      参数

      取值示例

      说明

      规则ID

      111111

      规则的全局唯一标识,说明如下:

      • 只能包含字母、数字、短划线(-)和下划线(_),至少包含一个字母或数字。

      • 名称长度限制在3~64字符之间,长于64字符将被自动截取。

      • 创建后无法更新。

      描述

      migrate from rocketmq

      对规则的描述。

      状态

      启用

      是否启用当前规则,取值说明如下:

      • 启用

      • 停用

      规则类型

      数据流出

      创建的规则类型,取值说明如下:

      • 数据流出:用于将云消息队列 MQTT 版的数据导出至其他阿里云产品。详细信息,请参见跨云产品的数据流出。

      • 数据流入:用于将其他阿里云产品的数据导入至云消息队列 MQTT 版。详细信息,请参见跨云产品数据流入。

      • 上下线通知:用于将获取的云消息队列 MQTT 版客户端上下线事件数据导出至其他阿里云产品。详细信息,请参见MQTT客户端上下线事件数据流出。

    2. 在配置规则源配置向导页面,配置数据源,然后单击下一步。

      参数

      取值示例

      说明

      Topic

      TopicA

      指定您需导出数据的源Topic,即云消息队列 MQTT 版的Topic。

      重要

      在云消息队列 MQTT 版中Topic是多级结构,而云消息队列 RocketMQ 版的Topic仅有一级,因此,云消息队列 MQTT 版中的一级Topic映射到云消息队列 RocketMQ 版的Topic,而子级Topic,包括二级、三级、n级Topic则映射到云消息队列 RocketMQ 版的消息属性(Properties)中。具体映射关系,请参见MQTT与RocketMQ的消息结构映射。

    3. 在配置规则目标配置向导页面,配置数据的流转目标,然后单击创建。

      参数

      取值示例

      说明

      目标服务类型

      消息队列 RocketMQ 版

      指定您需将源Topic的数据转发至的目标云产品。

      说明

      当前仅支持云消息队列 RocketMQ 版。

      RocketMQ 实例

      MQ_INST_13801563067*****_BbyOD2jQ

      指定目标云产品的实例ID,即云消息队列 RocketMQ 版的实例ID。

      说明

      仅支持选择和云消息队列 MQTT 版实例为同一地域的云产品实例。

      Topic

      TopicB

      指定目标云产品的资源键值,即云消息队列 RocketMQ 版的Topic。源Topic的数据将流转至TopicB。

    您可以在规则管理页面的RocketMQ 规则页签中查看到刚创建的数据流入规则。

说明 云消息队列 MQTT 版和云消息队列 RocketMQ 版的消息结构映射信息,请参见MQTT和RocketMQ的消息结构映射。

编辑数据流出规则

  1. 在规则管理页面,单击RocketMQ 规则页签。

  2. 在规则列表,找到您想编辑的规则,并在其操作列选择更多 > 编辑。

  3. 在编辑规则页面,您可以更新除规则ID以外的所有参数。

  4. 编辑完成后,在配置规则目标向导页面单击保存。

删除数据流出规则

  1. 在规则管理页面,单击RocketMQ 规则页签。

  2. 在规则列表,找到您想删除的规则,并在其操作列选择更多 > 删除。

  3. 在弹出的提示对话框,单击确认。

启用数据流出规则

  1. 在规则管理页面,单击RocketMQ 规则页签。

  2. 在规则列表,找到您想启用的规则,并在其操作列选择更多 > 启用。

  3. 在弹出的提示对话框,单击确认。

停用数据流出规则

  1. 在规则管理页面,单击RocketMQ 规则页签。

  2. 在规则列表,找到您想停用的规则,并在其操作列选择更多 > 停用。

  3. 在弹出的提示对话框,单击确认。

相关文档

如需将其他阿里云产品数据推送至客户端,请参见数据流入规则管理。