更新时间：2024-04-08 GMT+08:00
查询消费列表或详情
功能介绍
查询消费列表或详情。
URI
GET /v2/{project_id}/instances/{instance_id}/groups/{group}/topics
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID，获取方式请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID。 |
group |
是 |
String |
消费组名称。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
topic |
否 |
String |
待查询的topic，不指定时查询topic列表，指定时查询详情。 |
limit |
否 |
Integer |
当次查询返回的最大个数，默认值为10，取值范围为1~50。 最小值：1 最大值：50 缺省值：10 |
offset |
否 |
Integer |
偏移量，表示从此偏移量开始查询， offset大于等于0。 最小值：0 缺省值：0 |
请求参数
无
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
topics |
Array of strings |
Topic列表（当查询topic消费“列表”时才显示此参数）。 |
total |
Integer |
Topic总数（当查询topic消费“列表”时才显示此参数）。 |
lag |
Long |
消费堆积总数 |
max_offset |
Long |
消息总数 |
consumer_offset |
Long |
已消费消息数 |
brokers |
Array of Brokers objects |
Topic关联代理（当查询topic消费“详情”才显示此参数）。 |
请求示例
GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/groups/{group}/topics?topic=test0001
响应示例
状态码： 200
查询消费列表或详情成功。
查询消费组的topic列表成功。
{ "topics" : [ "topic-test" ], "total" : 1 }查询消费组详情成功。
{ "lag" : 0, "max_offset" : 1, "consumer_offset" : 1, "brokers" : [ { "broker_name" : "broker-0", "queues" : [ { "id" : 0, "lag" : 0, "broker_offset" : 0, "consumer_offset" : 0, "last_message_time" : 0 }, { "id" : 1, "lag" : 0, "broker_offset" : 1, "consumer_offset" : 1, "last_message_time" : 1679398537088 }, { "id" : 0, "lag" : 0, "broker_offset" : 0, "consumer_offset" : 0, "last_message_time" : 0 } ] } ] }
状态码
状态码 |
描述 |
|---|---|
200 |
查询消费列表或详情成功。 |
错误码
请参见错误码。
父主题： 消费组管理
