What is DescribeTopicPartitions?
Provides detailed partition metadata with cursor-based pagination for clusters with thousands of topics (KIP-966). This addresses the scalability limits of the Metadata API when listing all topics in large clusters, as Metadata was never designed for bulk enumeration.
Wire Diagram
Request Header · flexible
message_size
int32 · 4B
api_key
int16 · 2B
api_version
int16 · 2B
correlation_id
int32 · 4B
client_id
string (compact)
tagged
var
DescribeTopicPartitionsRequest v0
ResponsePartitionLimit
int32 · 4B
tagged
var
Name
string (compact)
tagged
var
TopicName
string (compact)
PartitionIndex
int32 · 4B
tagged
var
Schema & Example
Schema { "Topics": [{ "Name": string }], "ResponsePartitionLimit": int32, "Cursor": { "TopicName": string, "PartitionIndex": int32 }? }
Example { "Topics": [{ "Name": "orders" }], "ResponsePartitionLimit": 0, "Cursor": { "TopicName": "orders", "PartitionIndex": 3 }? }