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

查询指定消费组的消费成员

功能介绍

查询指定消费组的消费成员。

URI

GET /v2/{engine}/{project_id}/instances/{instance_id}/groups/{group}/members

表1 路径参数

参数

是否必选

参数类型

描述

engine

是

String

引擎。

project_id

是

String

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

instance_id

是

String

实例ID。

group

是

String

消费组ID。
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

偏移量，表示从此偏移量开始查询， offset大于等于0。

limit

否

Integer

当次查询返回的最大消费组成员个数，默认值为10，取值范围为1~50。

host

否

String

消费者地址。

member_id

否

String

消费者ID。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

members

Array of GroupMemberEntity objects

成员详情

total

Integer

总数
表4 GroupMemberEntity

参数

参数类型

描述

member_id

String

成员Id

client_id

String

客户端Id

请求示例

GET https://{endpoint}/v2/{engine}/{project_id}/instances/{instance_id}/groups/{group}/members

响应示例

状态码：200

查询成功。

{
  "members" : [ {
    "member_id" : "consumer-1-6b8ee551-d499-47d4-9beb-ba1527496785",
    "client_id" : "consumer-1"
  }, {
    "member_id" : "consumer-2-6b8ee551-d499-47d4-9beb-ba1527491125",
    "client_id" : "consumer-2"
  } ],
  "total" : 2
}

状态码

状态码

描述

200

查询成功。

错误码

请参见错误码。

父主题： 消费组管理