文档

上下线通知规则管理

更新时间:
一键部署

在客户端上线和下线事件触发时,MQTT服务器会根据您配置的客户端上下线通知规则,向后端其他云产品推送一条上下线消息。业务应用一般部署在阿里云的服务器上,业务应用通过向后端云产品订阅这条消息来获取所有客户端的上下线动作。

流程说明

上下线事件流出

规则限制

限制项

限制值

说明

单实例规则数量

100

如果默认限制不满足,请联系云消息队列 MQTT 版技术支持,钉钉群号:35228338。

规则去重限制

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

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

地域限制

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

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

云消息队列 MQTT 版实例版本

仅新版本的实例支持。

新购的云消息队列 MQTT 版实例默认为新版本实例,旧版实例已不支持购买。

云消息队列 RocketMQ 版实例版本

仅4.0系列实例支持

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

创建上下线通知规则

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

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

  3. 在左侧导航栏单击规则管理,然后在页面左上角,单击创建规则
  4. 创建规则页面完成以下操作。
    1. 配置基本信息配置向导页面,填写规则的基本信息,然后单击下一步
      参数取值示例说明
      规则ID111111规则的全局唯一标识,说明如下:
      • 只能包含字母、数字、短划线(-)和下划线(_),至少包含一个字母或数字。
      • 名称长度限制在3~64字符之间,长于64字符将被自动截取。
      • 创建后无法更新。
      描述migrate from rocketmq对规则的描述。
      状态启用是否启用当前规则,取值说明如下:
      • 启用
      • 停用
      规则类型上下线通知创建的规则类型,取值说明如下:
      • 数据流出:用于将云消息队列 MQTT 版的数据导出至其他阿里云产品。详细信息,请参见跨云产品的数据流出
      • 数据流入:用于将其他阿里云产品的数据导入至云消息队列 MQTT 版。详细信息,请参见跨云产品数据流入
      • 上下线通知:用于将获取的云消息队列 MQTT 版客户端上下线事件数据导出至其他阿里云产品。详细信息,请参见MQTT客户端上下线事件数据流出
    2. 配置规则源配置向导页面,配置数据源,然后单击下一步
      参数取值示例说明
      Group IDGID_Client_Status指定需导出数据的设备组。Group ID的详细信息,请参见名词解释
    3. 配置规则目标配置向导页面,配置数据的流转目标,然后单击创建
      参数取值示例说明
      目标服务类型消息队列 RocketMQ 版指定您需将云消息队列 MQTT 版客户端上下线通知流转至哪个目标云产品。
      说明 当前仅支持云消息队列 RocketMQ 版
      RocketMQ 实例MQ_INST_13801563067*****_BbyOD2jQ指定目标云产品的实例ID,即云消息队列 RocketMQ 版的实例ID。
      说明 仅支持选择和云消息队列 MQTT 版实例为同一地域的云产品实例。
      TopicTopicB指定目标云产品的资源键值,即云消息队列 RocketMQ 版的Topic。云消息队列 MQTT 版客户端上下线通知信息将流转至TopicB。
    您可以在规则管理的规则列表查看到刚创建的上下线通知规则。
说明 云消息队列 MQTT 版云消息队列 RocketMQ 版的消息结构映射信息,请参见MQTT和RocketMQ的消息结构映射

编辑上下线通知规则

  1. 在规则列表,找到您想编辑的规则,并在其操作列选择更多 > 编辑
  2. 编辑规则页面,您可以更新除规则ID以外的所有参数。
  3. 编辑完成后,在配置规则目标向导页面单击保存

删除上下线通知规则

  1. 在规则列表,找到您想删除的规则,并在其操作列选择更多 > 删除
  2. 在弹出的提示对话框,单击确认

启用上下线通知规则

  1. 在规则列表,找到您想启用的规则,并在其操作列选择更多 > 启用
  2. 在弹出的提示对话框,单击确认

停用上下线通知规则

  1. 在规则列表,找到您想停用的规则,并在其操作列选择更多 > 停用
  2. 在弹出的提示对话框,单击确认