Skip to content

MINOR: Do not advertise describe APIs on the controller listener - #23237

Open
stasimus wants to merge 1 commit into
apache:trunkfrom
stasimus:minor-controller-describe-apis-listeners
Open

MINOR: Do not advertise describe APIs on the controller listener#23237
stasimus wants to merge 1 commit into
apache:trunkfrom
stasimus:minor-controller-describe-apis-listeners

Conversation

@stasimus

Copy link
Copy Markdown

DescribeDelegationToken and DescribeUserScramCredentials declare the controller listener, so the controller advertises them in ApiVersions, but ControllerApis.handle has no case for either and clients get UNKNOWN_SERVER_ERROR for an API that was just advertised.

Dropped the controller listener so the advertised set matches what is implemented. Adding handlers instead would be new functionality. Happy to route this through a KIP if the ApiVersions change counts as a protocol change.

Both were introduced with their KRaft features (KAFKA-15219, KAFKA-14084), which wired up the mutating APIs but not the describes. Added two regression tests in ControllerApisTest.

DescribeDelegationToken and DescribeUserScramCredentials both declared
the controller listener, so the controller advertised them in its
ApiVersions response. ControllerApis.handle has no case for either, so
they fell through to the "Unsupported ApiKey" branch and clients got
UNKNOWN_SERVER_ERROR for an API the broker said it supported.

Both were added along with their KRaft features (KAFKA-15219 and
KAFKA-14084), which wired up the mutating APIs but not the describes.
Drop the controller listener so the advertised set matches what is
implemented.
@github-actions github-actions Bot added triage PRs from the community core Kafka Broker clients small Small PRs labels Aug 22, 2026
@stasimus

Copy link
Copy Markdown
Author

changes to the wire protocol "generally require a KIP", and this does change what the controller returns in its ApiVersions response - I take it a bugfix rather than a protocol change, since the API never worked on the controller and no functioning client behaviour change

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

clients core Kafka Broker small Small PRs triage PRs from the community

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant