文档首页/ 分布式消息服务Kafka版/ API参考（联盟区域）/ API V2（推荐）/ 消费组管理/ 创建消费组
更新时间：2025-12-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建消费组

功能介绍

实例创建消费组

URI

POST /v2/{project_id}/kafka/instances/{instance_id}/group

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方式请参见获取项目ID。

instance_id

是

String

实例ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

group_name

是

String

消费组名称

group_desc

否

String

消费组描述

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

-

String

创建结果

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

创建一个消费组，消费组名为test。

POST https://{endpoint}/v2/{project_id}/kafka/instances/{instance_id}/group

{
  "group_name" : "test"
}

响应示例

状态码：200

创建成功。

success

状态码

状态码

描述

200

创建成功。

400

创建失败。

错误码

请参见错误码。

父主题： 消费组管理