[
https://issues.apache.org/jira/browse/KAFKA-6962?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16977948#comment-16977948
]
ASF GitHub Bot commented on KAFKA-6962:
---------------------------------------
kdrakon commented on pull request #5091: KAFKA-6962 added better docs to
DESCRIBE_CONFIGS_REQUEST_RESOURCE_V0
URL: https://github.com/apache/kafka/pull/5091
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
> DescribeConfigsRequest Schema documentation is wrong/missing detail
> -------------------------------------------------------------------
>
> Key: KAFKA-6962
> URL: https://issues.apache.org/jira/browse/KAFKA-6962
> Project: Kafka
> Issue Type: Improvement
> Components: core
> Affects Versions: 1.1.0
> Reporter: Sean Policarpio
> Priority: Minor
>
> The Resource fields for DescribeConfigsRequest for the following fields are
> all {{null}}:
> * resource_type
> * resource_name
> * config_names
> -Additionally, after using the API, I've also noted that {{resource_name}}
> should probably be listed as a nullable String since it's optional.-
> The PR attached would output something like the following:
> *Requests:*
> {{DescribeConfigs Request (Version: 0) => [resources]}}
> {{ resources => resource_type resource_name [config_names]}}
> {{ resource_type => INT8}}
> {{ resource_name => STRING}}
> {{ config_names => STRING}}
>
> ||Field||Description||
> |resources|An array of config resources to be returned.|
> |resource_type|The resource type, which is one of 0 (UNKNOWN), 1 (ANY), 2
> (TOPIC), 3 (GROUP), 4 (BROKER)|
> |resource_name|The resource name to query.|
> |config_names|An array of config names to retrieve. If set to null, then all
> configs are returned for resource_name.|
>
> {{DescribeConfigs Request (Version: 1) => [resources] include_synonyms }}
> {{ resources => resource_type resource_name [config_names] }}
> {{ resource_type => INT8}}
> {{ resource_name => STRING}}
> {{ config_names => STRING}}
> {{ include_synonyms => BOOLEAN}}
> ||Field||Description||
> |resources|An array of config resources to be returned.|
> |resource_type|The resource type, which is one of 0 (UNKNOWN), 1 (ANY), 2
> (TOPIC), 3 (GROUP), 4 (BROKER)|
> |resource_name|The resource name to query.|
> |config_names|An array of config names to retrieve. If set to null, then all
> configs are returned for resource_name.|
> |include_synonyms|null|
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
