Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add link to discussion thread and clarify read only configs.

...

Current state: Under Discussion

Discussion thread: TBD here

JIRA

Jira
serverASF JIRA
serverId5aa69414-a9e9-3523-82ec-879b028fb15b
keyKAFKA-3267

...

  1. Can be sent to any broker
  2. If there are multiple instructions for the same resource in one request the extra request will be ignored
    • This is because the list of resources is modeled server side as a set
    • Multiple resources results in the same end goal, so handling this error for the user should be okay
    • This is similar to how delete topics handles requests
  3. If the config_name array is null, all configs are returned. Otherwise, configs with the provided names are returned.
  4. Valid resource types are "Topic", "Client", "User" and "Broker".
  5. If resource_type is "Broker" and resource_name matches the broker that has received the request, read-only configs (i.e. configs that can only be defined statically, typically via server.properties) for this broker are also returned. Note that brokers are the only resource type with read-only configs at this point.
  6. The principal must be authorized to "ReadConfigs" on the "Cluster" resource ("ReadConfigs" is also included in the "All" operation). Unauthorized requests will receive a ClusterAuthorizationFailed error code.
  7. Errors are reported independently per resource.

...