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

Kafka InitializeShareGroupState Request Wire Format v0 — Binary Protocol Layout

What is InitializeShareGroupState?

Sets up the persistent state partition in __share_group_state before a share group can start consuming (internal, not called by operators). Failures here (e.g., authorization issues on the internal topic) prevent share groups from starting.

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
InitializeShareGroupStateRequest v0
GroupId string (compact)
Topics array
tagged var
TopicId uuid · 16B
Partitions array
tagged var
Partition int32 · 4B
StateEpoch int32 · 4B
StartOffset int64 · 8B
tagged var

Schema & Example

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