conduktor.io ↗

Kafka DescribeCluster Request Wire Format v2 — Binary Protocol Layout

What is DescribeCluster?

Returns the authoritative list of brokers, the active controller, and cluster-level authorized operations via AdminClient.describeCluster(). Unlike Metadata, this can filter by endpoint type (broker vs controller), which matters in KRaft mode where controllers may not be brokers.

Related Errors

MISMATCHED_ENDPOINT_TYPE · UNSUPPORTED_ENDPOINT_TYPE

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
DescribeClusterRequest v2
IncludeClusterAuthorizedOperations bool · 1B
EndpointType int8 · 1B
IncludeFencedBrokers bool · 1B
tagged var

Schema & Example

Schema
{
  "IncludeClusterAuthorizedOperations": bool,
  "EndpointType": int8,
  "IncludeFencedBrokers": bool
}
Example
{
  "IncludeClusterAuthorizedOperations": 2,
  "EndpointType": 1,
  "IncludeFencedBrokers": true
}