conduktor.io ↗

Kafka ReadShareGroupStateSummary Request 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

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
ReadShareGroupStateSummaryRequest v0
GroupId string (compact)
Topics array
tagged var
TopicId uuid · 16B
Partitions array
tagged var
Partition int32 · 4B
LeaderEpoch int32 · 4B
tagged var

Schema & Example

Schema
{
  "GroupId": string,
  "Topics": [{
      "TopicId": uuid,
      "Partitions": [{
          "Partition": int32,
          "LeaderEpoch": int32
      }]
  }]
}
Example
{
  "GroupId": "order-processors",
  "Topics": [{
      "TopicId": "550e8400-e29b-41d4-a716-446655440000",
      "Partitions": [{
          "Partition": 0,
          "LeaderEpoch": 17
      }]
  }]
}