查询Kafka实例Topic详细信息
功能介绍
查询Kafka实例Topic详细信息。(单个实例调用不要超过1s一次)
URI
GET /v2/{project_id}/instances/{instance_id}/management/topics/{topic}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID,获取方式请参见获取项目ID。 |
|
instance_id |
是 |
String |
实例ID。 |
|
topic |
是 |
String |
Topic名称。 |
请求参数
无
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
topic |
String |
topic名称。 |
|
partitions |
Array of partitions objects |
分区列表。 |
|
group_subscribed |
Array of strings |
订阅该topic的消费组名称列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
partition |
Integer |
分区ID。 |
|
leader |
Integer |
leader副本所在节点的id。 |
|
leo |
Integer |
分区leader副本的LEO(Log End Offset)。 |
|
hw |
Integer |
分区高水位(HW,High Watermark)。 |
|
lso |
Integer |
分区leader副本的LSO(Log Start Offset)。 |
|
last_update_timestamp |
Long |
分区上次写入消息的时间。 格式为Unix时间戳。 单位:毫秒。 |
|
replicas |
Array of replicas objects |
副本列表。 |
请求示例
查询指定Topic的详细信息。
GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/management/topics/{topic}
响应示例
状态码: 200
查询成功。
{
"topic" : "test",
"partitions" : [ {
"partition" : 0,
"leader" : 2,
"replicas" : [ {
"broker" : 2,
"leader" : true,
"in_sync" : true,
"size" : 123971146,
"lag" : 0
}, {
"broker" : 1,
"leader" : false,
"in_sync" : true,
"size" : 123971146,
"lag" : 0
}, {
"broker" : 0,
"leader" : false,
"in_sync" : true,
"size" : 123971146,
"lag" : 0
} ],
"lso" : 0,
"leo" : 13598,
"hw" : 13598,
"last_update_timestamp" : 1571477180985
}, {
"partition" : 2,
"leader" : 1,
"replicas" : [ {
"broker" : 1,
"leader" : true,
"in_sync" : true,
"size" : 123889531,
"lag" : 0
}, {
"broker" : 0,
"leader" : false,
"in_sync" : true,
"size" : 123889531,
"lag" : 0
}, {
"broker" : 2,
"leader" : false,
"in_sync" : true,
"size" : 123889531,
"lag" : 0
} ],
"lso" : 0,
"leo" : 13601,
"hw" : 13601,
"last_update_timestamp" : 1571477077146
}, {
"partition" : 1,
"leader" : 0,
"replicas" : [ {
"broker" : 0,
"leader" : true,
"in_sync" : true,
"size" : 127245604,
"lag" : 0
}, {
"broker" : 2,
"leader" : false,
"in_sync" : true,
"size" : 127245604,
"lag" : 0
}, {
"broker" : 1,
"leader" : false,
"in_sync" : true,
"size" : 127245604,
"lag" : 0
} ],
"lso" : 0,
"leo" : 13599,
"hw" : 13599,
"last_update_timestamp" : 1571477172959
} ],
"group_subscribed" : [ "test-consumer-group" ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询成功。 |
错误码
请参见错误码。