概述
消息队列 MQTT 版(TDMQ for MQTT,简称 TDMQ MQTT 版)是一款分布式高可用的消息队列服务,通过 “发布/订阅” 模式构建了极其轻量化的消息传输协议。TDMQ MQTT 版兼容标准的 MQTT 协议,支持开源社区和业内主流 MQTT 客户端零改造接入,并在稳定性、低延迟和高性能等特性上做了加强,支持百万客户端同时在线。
本章节介绍的消息队列 MQTT 版 API 接口均为 API 3.0 接口。您可以调用 API 对消息队列 MQTT 版进行操作,例如创建集群、授权等。
消息队列 MQTT 版支持的所有接口信息,请参见 API 概览。
术语表
消息队列 MQTT 版 API 接口的常见术语请参见下表:
| 术语 | 描述 |
|---|---|
| MQTT | 一种物联网和移动互联网领域的行业标准协议,适合移动终端之间的数据传输。 |
| MQTT 服务端 | 实现 MQTT 协议的服务端,负责保持和 MQTT 客户端的长连接,并且将消息路由到对应的客户端,或将消息转发到其他 MQTT 服务端节点,同时负责 MQTT 离线消息的存储。 |
| MQTT 客户端 | 使用 MQTT 协议连接到 MQTT 服务端的设备或应用程序。 |
| 主题Topic | 用来标识消息的分类和结构,Publisher 将消息发布到特定的主题上,Subscriber 订阅特定的主题以接收相关消息。 |
其他相关术语请参见 基本概念。
使用限制
消息队列 MQTT 版的使用限制请参见配额与限制。
对于具体的参数限制,请参考各接口文档中的参数说明。
API 快速入门
您可以使用 API Explorer 工具在线调用 API。
本文以消息队列 MQTT 版 为例,通过 API Explorer 工具调用 API 接口的步骤如下:
- 进入 API Explorer 工具页面。更多 API Explorer 工具使用信息,请参见 使用 API Explorer。
- 调用 CreateMQTTInstance,创建一个 MQTT 集群。
- 调用 CreateMQTTUser,创建一个用户。
- 调用 CreateAuthorizationPolicy,为用户授予连接集群、并可以生产消费消息权限。
- 使用客户端收发消息(本操作不支持通过 API 接口完成)。
- 调用 DescribeMessageByTopic,查询消息。