删除消费组
所有文档
menu

消息服务 for Kafka

删除消费组

产品详情立即开通

该接口用于删除集群中的消费组。

  • 集群处于服务中状态(ACTIVE)。

请求结构

DELETE /v{version}/clusters/{clusterId}/consumer-groups/{groupName} HTTP/1.1
Host: kafka-api.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其他特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
version String URL参数 API版本号
clusterId String URL参数 待删除消费组的集群ID
groupName String URL参数 待删除的消费组名称

返回头域

除公共头域外,无其他特殊头域。

返回参数

参数名称 类型 描述
groupName String 成功删除的消费组名称

错误码

错误码 错误描述 HTTP状态码 描述
ERROR_PARAMS 请求参数错误 400 请求参数错误
CLUSTER_NOT_FOUND 集群不存在 451 集群不存在
CLUSTER_HAD_DELETED 集群已删除 451 集群已删除
CLUSTER_NOT_BELONGED 未拥有该集群 451 未拥有该集群
CLUSTER_NOT_ACTIVE 集群非运行状态 451 集群非运行状态
CONSUMER_GROUP_NOT_FOUND 消费组不存在 451 消费组不存在
INTERNAL_ERROR 服务内部错误 500 服务内部错误

请求示例

DELETE http://kafka-api.bj.baidubce.com/v2/clusters/33a168bb70c0459787416077114ab233/consumer-groups/group-id-test
Authorization: bce-auth-v1/ALTAKaiKeDfBD880eMWBE5oIGE/2023-05-08T11:43:45Z/1800/host;x-bce-date/322f3f98ce57d296c0f5abc64e5554b640ea035c5cb462fcaeab54b9810a3c61
Host: kafka-api.bj.baidubce.com

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 97e6d4ad-6fca-4609-ad4d-9a27c4d1a362
Date: Mon, 08 May 2023 09:39:11 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "groupName": "group-id-test"
}
上一篇
主题管理接口
下一篇
查询消费组列表