本文介绍如何在微消息队列MQTT版控制台上管理客户端上下线通知规则。

背景信息

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

使用限制

请参见规则限制。

创建上下线通知规则

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

编辑上下线通知规则

  1. 登录微消息队列MQTT版控制台。
  2. 在左侧导航栏单击实例列表。
  3. 在顶部菜单栏选择地域。
  4. 在实例列表中找到目标实例，在其操作列，选择更多 > 规则管理。
  5. 在规则列表，找到您想编辑的规则，并在其操作列选择更多 > 编辑。
  6. 在编辑规则页面，您可以更新除规则ID以外的所有参数。
  7. 编辑完成后，在配置规则目标向导页面单击保存。

删除上下线通知规则

  1. 登录微消息队列MQTT版控制台。
  2. 在左侧导航栏单击实例列表。
  3. 在顶部菜单栏选择地域。
  4. 在实例列表中找到目标实例，在其操作列，选择更多 > 规则管理。
  5. 在规则列表，找到您想删除的规则，并在其操作列选择更多 > 删除。
  6. 在弹出的提示对话框，单击确认。

启用上下线通知规则

  1. 登录微消息队列MQTT版控制台。
  2. 在左侧导航栏单击实例列表。
  3. 在顶部菜单栏选择地域。
  4. 在实例列表中找到目标实例，在其操作列，选择更多 > 规则管理。
  5. 在规则列表，找到您想启用的规则，并在其操作列选择更多 > 启用。
  6. 在弹出的提示对话框，单击确认。

停用上下线通知规则

  1. 登录微消息队列MQTT版控制台。
  2. 在左侧导航栏单击实例列表。
  3. 在顶部菜单栏选择地域。
  4. 在实例列表中找到目标实例，在其操作列，选择更多 > 规则管理。
  5. 在规则列表，找到您想停用的规则，并在其操作列选择更多 > 停用。
  6. 在弹出的提示对话框，单击确认。