文档

订阅关系清理

更新时间:
一键部署
重要

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

本文介绍如何在云消息队列 MQTT 版控制台为指定Topic配置订阅关系清理功能。

背景信息

订阅关系清理功能的相关背景信息和计费说明如下:

  • 某个Topic配置了订阅关系清理功能后,当订阅者的客户端离线并超过指定时间后,云消息队列 MQTT 版会删除订阅者与该Topic的订阅关系。若不清理订阅关系,订阅者客户端离线期间订阅关系将持续生效,当客户端再次上线时,云消息队列 MQTT 版将自动加载离线消息并下发到客户端。

  • 若您对离线消息有时效性要求或业务侧判断订阅者失效不需再使用时,可以通过此功能清理订阅的Topic关系。

  • 云消息队列 MQTT 版是否会自动加载离线消息并下发到客户端,需要根据QoScleanSession两个参数来决定。更多信息,请参见名词解释

  • 订阅关系变化会影响实例的计费情况,计费的更多信息,请参见计费概述

操作步骤

警告

若开启订阅关系清理功能,客户端将收不到离线消息,请慎重操作。

  1. 登录云消息队列 MQTT 版控制台,并在左侧导航栏单击实例列表
  2. 在顶部菜单栏选择目标地域,然后在实例列表中单击实例名称进入实例详情页面。
  3. 在左侧导航栏单击Topic 管理,然后在Topic列表中找到目标Topic,在其操作列,选择更多 > 订阅关系清理

  4. 在弹出的自动清理周期配置面板,设置开启自动订阅关系清理清理周期,单击确定

    • 开启自动订阅关系清理设置为:当系统当前时间−客户端最后一次心跳时间≥清理周期时,系统将清理订阅者与该Topic的订阅关系。订阅关系清理后,客户端将收不到该Topic产生的离线消息。

      重要

      当客户端再次上线时,依然可以接收到订阅关系清理前产生的、且在有效期内的离线消息。

    • 开启自动订阅关系清理设置为:订阅者客户端离线期间,系统不会清理订阅者与该Topic的订阅关系,订阅关系持续生效。

    配置完成后,您可以在Topic列表的订阅关系清理周期列查看Topic的清理周期。