conduktor.io ↗

Kafka IncrementalAlterConfigs Request Wire Format v1 — Binary Protocol Layout

What is IncrementalAlterConfigs?

Applies targeted config changes via kafka-configs.sh (v2.3+) without touching other settings. Supports SET, DELETE, APPEND, and SUBTRACT operations. Use this instead of AlterConfigs, which is legacy and wipes unspecified keys.

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
IncrementalAlterConfigsRequest v1
Resources array
ValidateOnly bool · 1B
tagged var
ResourceType int8 · 1B
ResourceName string (compact)
Configs array
tagged var
Name string (compact)
ConfigOperation int8 · 1B
Value? string (compact)
tagged var

Schema & Example

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