更新时间:2025-09-03 GMT+08:00

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

功能介绍

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

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

查询成功。

错误码

请参见错误码