API 简介

最近更新时间:2021-01-14 15:39:23

我的收藏
Note:
当前页面接口为旧版 API,未来可能停止维护。消息队列 CKafka API3.0 版本接口定义更加规范,访问时延下降显著,建议使用 消息队列 CKafka API3.0
如果您需要访问消息队列 CKafka 旧版 API,可参见 API 概览
欢迎使用消息队列 CKafka。
消息队列 CKafka 运行在腾讯数据中心,它提供了可以弹性伸缩的消息队列服务。
消息队列 CKafka 向用户提供弹性的存储和网络资源。用户可以使用本文档介绍的 API,并参照相应的示例,对消息队列 CKafka 进行相关操作:如创建、销毁、升配等;支持的全部操作可参见 API 概览
请确保在使用这些接口前,已充分了解了 消息队列 CKafka 概述

术语表

本文档涉及的一些常用术语如下:
术语
全称
中文
说明
Instance
Instance
服务器实例
指代一台消息队列服务器。这里的一台消息队列服务器是逻辑上的概念,物理上是由多台物理机提供服务。
Region
Region
表示资源所在的地域,每个地域包含一个或多个可用区。
Zone
Zone
指腾讯云在同一 地域 内电力和网络互相独立的物理数据中心。目标是能够保证可用区之间故障相互隔离,不出现故障扩散,使得用户的业务持续在线服务。
包年包月
包年包月
包年包月
一种计费模式,参看 计费模式
按量计费
按量计费
按量计费
一种计费模式,参看 计费模式

输入参数与返回参数释义

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 接口文档或产品文档。