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
message_size
int32 · 4B
api_key
int16 · 2B
api_version
int16 · 2B
correlation_id
int32 · 4B
client_id
string
IncrementalAlterConfigsRequest v0
ValidateOnly
bool · 1B
ResourceType
int8 · 1B
ResourceName
string
Name
string
ConfigOperation
int8 · 1B
Value?
string
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": "604800000" }] }], "ValidateOnly": true }