Note:
当前页面接口为旧版 API,未来可能停止维护。消息队列 CKafka API3.0 版本接口定义更加规范,访问时延下降显著,建议使用 消息队列 CKafka API3.0。
如果您需要访问消息队列 CKafka 旧版 API,可参见 API 概览。
欢迎使用消息队列 CKafka。
消息队列 CKafka 运行在腾讯数据中心,它提供了可以弹性伸缩的消息队列服务。
消息队列 CKafka 向用户提供弹性的存储和网络资源。用户可以使用本文档介绍的 API,并参照相应的示例,对消息队列 CKafka 进行相关操作:如创建、销毁、升配等;支持的全部操作可参见 API 概览。
术语表
本文档涉及的一些常用术语如下:
输入参数与返回参数释义
Limit 和 Offset
用来控制分页的参数;Limit 为单次返回的最多条目数量,Offset 为偏移量。当相应结果是列表形式时,如果数量超过了 Limit 所限定的值,那么只返回 Limit 个值。
例如,参数 Offset=0&Limit=20返回第0到19项,Offset=20&Limit=20返回第20到39项,Offset=40&Limit=20返回第40到59项,以此类推。
topic.N(数组参数)
同时输入多个参数的格式。当遇到形如这样的格式(String Array)时,那么该输入参数可以同时传多个,即该参数为数组参数,数组参数入参如下所示:
topic.0=test1&topic.1=test2&topic.2=test3,以此类推(以下标0开始)。
API 快速入门
这里针对几个典型的使用场景对消息队列 CKafka API 的使用方式进行说明:
通过使用 创建主题 API,提供实例 ID、主题名称、分区个数,副本个数等一些必要的信息,即可立刻创建出一个 Topic。
如需修改主题配置,可以使用 修改主题属性接口 API 调整主题的配置。
使用限制
消息队列 CKafka API 调用配额为:100次/分钟,且单一 API 不超过100次/分钟。
更具体的限制请参考对应 API 接口文档或产品文档。