tencent cloud

消息队列 MQTT 版

动态与公告
新功能发布记录
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 MQTT 版
应用场景
技术架构
产品系列
MQTT 协议兼容说明
开源对比
高可用
产品约束与使用配额
基本概念
开服地域
购买指南
计费概述
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
准备工作
公网接入
VPC 网络接入
用户指南
使用流程指引
配置账号权限
新建集群
管理 Topic
连接集群
查询消息
管理客户端
管理集群
查看监控和配置告警
数据集成
集成数据到云函数 SCF
集成数据到 CKafka
集成数据到 RocketMQ
开发指南
MQTT 5 高级特性
数据面 HTTP 接口说明
配置自定义域名
配置 SQL 过滤
配置点对点订阅
MQTT over QUIC
管理客户端订阅
消息增强规则
实践教程
MQTT 客户端开发注意事项
可观测能力
Topic 与通配符订阅
API 参考
History
Introduction
API Category
Making API Requests
Cluster APIs
Topic APIs
Authorization Policy APIs
User APIs
Client APIs
Message Enhancement Rule APIs
Message APIs
Data Types
Error Codes
SDK 参考
接入点格式
Java SDK
C SDK
Javascript/Node.JS/小程序
Go SDK
iOS SDK
JavaScript SDK
Dart SDK
Python SDK
.NET
安全与合规
权限管理
常见问题
相关协议
隐私协议
数据处理和安全协议
消息队列 MQTT 版服务等级协议
联系我们

管理客户端订阅

PDF
聚焦模式
字号
最后更新时间: 2026-01-30 15:24:11
消息队列 MQTT 版提供灵活的订阅管理功能,支持对订阅列表进行动态维护:即添加订阅和删除订阅。
订阅添加:无需重新连接即可新增订阅主题。
订阅删除:可随时移除不再需要的主题订阅。

使用场景

物联网设备管理场景

适用于固件难以更新的传统物联网设备。
解决老旧设备无法通过 OTA 升级重新配置订阅的问题。
避免因订阅变更导致的设备重启或重连。

开发测试场景

显著提升开发调试效率,免除频繁烧录 ROM 的操作。
支持快速验证不同主题下的消息处理逻辑。
便于进行多主题并行测试,缩短开发周期。
说明:
添加订阅与删除订阅的云 API 实时生效。

API 详情

添加订阅

MQTT 提供云 API,给指定 Client ID 的会话(Session)增加新的订阅。
参数名称
含义
示例
InstanceId
实例 ID
mqtt-sample
ClientId
客户端 ID
v-xy34213qz
TopicFilter
Topic Filter
home/#
QoS
服务质量,取值:0,1, 2
1

删除订阅

MQTT 提供云 API,从指定 Client ID 的会话(Session)删除订阅。
参数名称
含义
示例
InstanceId
实例 ID
mqtt-sample
ClientId
客户端 ID
v-xy34213qz
TopicFilter
Topic Filter
home/#

自动订阅管理

自动订阅管理是一种基于事件驱动的 MQTT 应用模式,能够显著提升订阅管理的灵活性与自动化水平,适用于设备动态性强、订阅关系复杂的物联网场景。



其完整工作流程如下:
​​设备连接​​:某一 IoT 设备上线,成功连接至 MQTT Broker。
​​事件触发:​​MQTT Broker 在检测到设备连接后,会立即生成一个“客户端已连接”事件,并将事件详情(包括客户端 ID、连接时间戳等元数据)发布到系统主题 $events/client_connected上。
​​事件监听与接收​​:始终订阅 $events/client_connected主题的应用程序,会实时接收到该事件通知。
​​订阅逻辑执行​​:应用程序解析事件消息,获取新上线设备的客户端 ID 等信息,随后​​根据预设的业务逻辑​​,代表该设备向 MQTT Broker 发起相应的订阅管理操作,例如为其订阅特定的主题或取消某些订阅。
通过将客户端生命周期事件与订阅列表管理能力相结合,可轻松构建灵活的自动订阅机制。该模式实现了在设备连接时根据业务需要,自动添加或者修改订阅,极大提升了系统在动态环境下的自适应能力与运维效率。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈