conduktor.io ↗

Kafka UnregisterBroker Response Wire Format v0 — Binary Protocol Layout

What is UnregisterBroker?

Permanently removes a broker's registration from the KRaft controller during decommissioning. Unlike a normal shutdown (which just stops heartbeats), this cleans up the broker's presence from the metadata log. Use this when a broker will never rejoin, not during routine maintenance.

Related Errors

BROKER_ID_NOT_REGISTERED

Wire Diagram

Response Header · flexible
message_size int32 · 4B
correlation_id int32 · 4B
tagged var
UnregisterBrokerResponse v0
ThrottleTimeMs int32 · 4B
ErrorCode int16 · 2B
ErrorMessage? string (compact)
tagged var

Schema & Example

Schema
{
  "ThrottleTimeMs": int32,
  "ErrorCode": int16,
  "ErrorMessage": string?
}
Example
{
  "ThrottleTimeMs": 0,
  "ErrorCode": 0,
  "ErrorMessage": "NETWORK_EXCEPTION"
}