conduktor.io ↗

Kafka AlterClientQuotas Request Wire Format v0 — Binary Protocol Layout

What is AlterClientQuotas?

Sets per-user or per-client-id throughput quotas via kafka-configs.sh --alter --entity-type. Quotas are enforced per broker and can be scoped to user level, client-id level, or their intersection. A missing entry means the default quota applies (unlimited if not configured).

Wire Diagram

Request Header
message_size int32 · 4B
api_key int16 · 2B
api_version int16 · 2B
correlation_id int32 · 4B
client_id string
AlterClientQuotasRequest v0
Entries array
ValidateOnly bool · 1B
Entity array
Ops array
EntityType string
EntityName? string
Key string
Value float64 · 8B
Remove bool · 1B

Schema & Example

Schema
{
  "Entries": [{
      "Entity": [{
          "EntityType": string,
          "EntityName": string?
      }],
      "Ops": [{
          "Key": string,
          "Value": float64,
          "Remove": bool
      }]
  }],
  "ValidateOnly": bool
}
Example
{
  "Entries": [{
      "Entity": [{
          "EntityType": "client-id",
          "EntityName": "orders"
      }],
      "Ops": [{
          "Key": "retention.ms",
          "Value": 0.0,
          "Remove": true
      }]
  }],
  "ValidateOnly": true
}