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

Kafka AlterConfigs Request Wire Format v0 — Binary Protocol Layout

What is AlterConfigs?

Updates broker or topic configuration, but replaces the entire config, not just the changed keys. Prefer IncrementalAlterConfigs for any new code; AlterConfigs silently resets configs not explicitly included in the request.

Related Errors

NOT_CONTROLLER · POLICY_VIOLATION

Wire Diagram

Request Header
message_size int32 · 4B
api_key int16 · 2B
api_version int16 · 2B
correlation_id int32 · 4B
client_id string
AlterConfigsRequest v0
Resources array
ValidateOnly bool · 1B
ResourceType int8 · 1B
ResourceName string
Configs array
Name string
Value? string

Schema & Example

Schema
{
  "Resources": [{
      "ResourceType": int8,
      "ResourceName": string,
      "Configs": [{
          "Name": string,
          "Value": string?
      }]
  }],
  "ValidateOnly": bool
}
Example
{
  "Resources": [{
      "ResourceType": 2,
      "ResourceName": "orders",
      "Configs": [{
          "Name": "orders",
          "Value": "604800000"
      }]
  }],
  "ValidateOnly": true
}