Kafka Configs Kafka Protocol Wire Format API Versions KIPs Errors Kafka Upgrade Config Advisor Flink SQL
conduktor.io ↗

Kafka ReadShareGroupStateSummary Response Wire Format v0 — Binary Protocol Layout

What is ReadShareGroupStateSummary?

Reads only the epoch and start offset without fetching full delivery state, for lightweight coordination checks. The coordinator uses this to quickly verify state consistency without the overhead of a full ReadShareGroupState, particularly during startup and failover.

Related Errors

CLUSTER_AUTHORIZATION_FAILED · COORDINATOR_NOT_AVAILABLE

Wire Diagram

Response Header · flexible
message_size int32 · 4B
correlation_id int32 · 4B
tagged var
ReadShareGroupStateSummaryResponse v0
Results array
tagged var
TopicId uuid · 16B
Partitions array
tagged var
Partition int32 · 4B
ErrorCode int16 · 2B
ErrorMessage? string (compact)
StateEpoch int32 · 4B
LeaderEpoch int32 · 4B
StartOffset int64 · 8B
tagged var

Schema & Example

Schema
{
  "Results": [{
      "TopicId": uuid,
      "Partitions": [{
          "Partition": int32,
          "ErrorCode": int16,
          "ErrorMessage": string?,
          "StateEpoch": int32,
          "LeaderEpoch": int32,
          "StartOffset": int64
      }]
  }]
}
Example
{
  "Results": [{
      "TopicId": "550e8400-e29b-41d4-a716-446655440000",
      "Partitions": [{
          "Partition": 0,
          "ErrorCode": 0,
          "ErrorMessage": "NETWORK_EXCEPTION",
          "StateEpoch": 12,
          "LeaderEpoch": 17,
          "StartOffset": 150382
      }]
  }]
}