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

Kafka ShareGroupDescribe Response Wire Format v1 — Binary Protocol Layout

What is ShareGroupDescribe?

Shows share group state including which members hold which partitions and the current assignment epoch. Share groups are stateful on the broker side (delivery counts, acquisition locks), making this more detailed than consumer group describe.

Related Errors

GROUP_AUTHORIZATION_FAILED · GROUP_ID_NOT_FOUND · TOPIC_AUTHORIZATION_FAILED · UNSUPPORTED_VERSION

Wire Diagram

Response Header · flexible
message_size int32 · 4B
correlation_id int32 · 4B
tagged var
ShareGroupDescribeResponse v1
ThrottleTimeMs int32 · 4B
Groups array
tagged var
ErrorCode int16 · 2B
ErrorMessage? string (compact)
GroupId string (compact)
GroupState string (compact)
GroupEpoch int32 · 4B
AssignmentEpoch int32 · 4B
AssignorName string (compact)
Members array
AuthorizedOperations int32 · 4B
tagged var
MemberId string (compact)
RackId? string (compact)
MemberEpoch int32 · 4B
ClientId string (compact)
ClientHost string (compact)
SubscribedTopicNames []string
Assignment struct
tagged var
TopicPartitions array
tagged var
TopicId uuid · 16B
TopicName string (compact)
Partitions []int32
tagged var

Schema & Example

Schema
{
  "ThrottleTimeMs": int32,
  "Groups": [{
      "ErrorCode": int16,
      "ErrorMessage": string?,
      "GroupId": string,
      "GroupState": string,
      "GroupEpoch": int32,
      "AssignmentEpoch": int32,
      "AssignorName": string,
      "Members": [{
          "MemberId": string,
          "RackId": string?,
          "MemberEpoch": int32,
          "ClientId": string,
          "ClientHost": string,
          "SubscribedTopicNames": [string],
          "Assignment": {
            "TopicPartitions": [{
                "TopicId": uuid,
                "TopicName": string,
                "Partitions": [int32]
            }]
          }
      }],
      "AuthorizedOperations": int32
  }]
}
Example
{
  "ThrottleTimeMs": 0,
  "Groups": [{
      "ErrorCode": 0,
      "ErrorMessage": null,
      "GroupId": "order-processors",
      "GroupState": "Stable",
      "GroupEpoch": 12,
      "AssignmentEpoch": 12,
      "AssignorName": "uniform",
      "Members": [{
          "MemberId": "consumer-1-abc123",
          "RackId": null,
          "MemberEpoch": 12,
          "ClientId": "my-app-producer",
          "ClientHost": "192.168.1.100",
          "SubscribedTopicNames": ["value-1", "value-2"],
          "Assignment": {
            "TopicPartitions": [{
                "TopicId": "550e8400-e29b-41d4-a716-446655440000",
                "TopicName": "orders",
                "Partitions": [1, 2, 3]
            }]
          }
      }],
      "AuthorizedOperations": 2
  }]
}