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.
| Version | Kafka | Changes |
|---|---|---|
| DescribeClusterRequest | ||
| v0 | 2.8 | + IncludeClusterAuthorizedOperations bool~ Flexible encoding enabled FLEXIBLE |
| v1 | 3.7 | + EndpointType int8adds EndpointType for KIP-919 support. |
| v2 | 4.0 | + IncludeFencedBrokers booladds IncludeFencedBrokers for KIP-1073 support. |
| DescribeClusterResponse | ||
| v0 | 2.8 | + ThrottleTimeMs int32+ ErrorCode int16+ ErrorMessage string+ ClusterId string+ ControllerId int32+ Brokers []DescribeClusterBroker+ BrokerId int32+ Host string+ Port int32+ Rack string+ ClusterAuthorizedOperations int32~ Flexible encoding enabled FLEXIBLE |
| v1 | 3.7 | + EndpointType int8adds the EndpointType field, and makes MISMATCHED_ENDPOINT_TYPE and UNSUPPORTED_ENDPOINT_TYPE valid top-level response error codes. |
| v2 | 4.0 | + IsFenced booladds IsFenced field to Brokers for KIP-1073 support. |