概述
消息队列 RocketMQ 版(TDMQ for RocketMQ,简称 TDMQ RocketMQ 版)是一款分布式高可用的消息队列服务, 基于 Apache RocketMQ 的 4.x 和 5.x 架构提供不同的产品形态,支持 RocketMQ 4.4.x 及以上版本的客户端零改造接入,同时具备计算存储分离,灵活扩缩容的底层优势。TDMQ RocketMQ 版最多可以支持百万级 TPS 的吞吐量,适用于各类大规模、低延时、对可靠性要求高的在线消息业务场景。
本章节介绍的 TDMQ RocketMQ 5.x 版本 API 接口均为 API 3.0 接口。您可以调用 API 对 TDMQ RocketMQ 5.x 集群进行操作,例如创建集群、Topic 等。
TDMQ RocketMQ 5.x 支持的所有接口信息,请参见 5.x API 概览。
TDMQ RocketMQ 4.x 支持的所有接口信息,请参见 4.x API 概览。
术语表
TDMQ RocketMQ 版 API 接口的常见术语请参见下表:
| 术语 | 描述 |
|---|---|
| 集群 | 集群是 TDMQ RocketMQ 版中的一个资源维度,不同集群的 Topic、Group 等资源完全隔离。每个集群会有集群的资源限制例如 Topic 总数、消息保留时长等。 |
| Topic | Topic 表示一类消息的集合,每个主题包含若干消息,是 RocketMQ 进行消息订阅的基本单位。 |
| Group | 可分为生产者组和消费者组: |
| Producer | 生产者是 RocketMQ 系统中用来构建并传输消息到服务端的运行实体。生产者通常被集成在业务系统中,将业务消息按照要求封装成消息并发送至服务端。 |
| Consumer | 消费者是 RocketMQ 中用来接收并处理消息的运行实体。消费者通常被集成在业务系统中,从服务端获取消息,并将消息转化成业务可理解的信息,供业务逻辑处理。 |
其他相关术语请参见 基本概念。
使用限制
TDMQ RocketMQ 版的使用限制请参见 配额与限制。
对于具体的参数限制,请参考各接口文档中的参数说明。
API 快速入门
您可以使用 API Explorer 工具在线调用 API。
本文以 TDMQ RocketMQ 5.x 集群为例,通过 API Explorer 工具调用 API 接口的步骤如下:
- 进入 API Explorer 工具页面。更多 API Explorer 工具使用信息,请参见 使用 API Explorer。
- 调用 CreateInstance 接口,创建一个集群。
- 调用 CreateTopic 接口,在集群下创建一个 Topic。
- 调用 CreateConsumerGroup 接口,在集群下创建一个 Group。
- 调用 CreateRole 接口,在集群下创建一个角色,并为其授予集群的生产消费权限。
- 使用客户端收发消息(本操作不支持通过 API 接口完成)。