Page History

...

Limit: 1000 partitions max per response.

The caller can specify the topic partitions OR try to query can query the partitions with the first partition id(-1 means fetch all the partitions, others mean to fetch the partition with and after this index).

If the server finds more than 1000 partitions to be included, only the first 1000(alphabet order) will be returned with info.

...

1. If a part of the partitions for a topic can't be returned, the first partition not returned will be specified in the next partition field. The rest of the partition will not show up in the response.
2. If the quota of the 1000 partitions has been used up, the rest of the topics will be returned with REQUEST_LIMIT_REACHED.
3. If the request searches for specific partitions
   1. All the partitions specified but can't be returned due to the quota limit will be returned with REQUEST_LIMIT_REACHED

Note, the request can have a mix of partition-specific topics and range-query topics.

{
  "apiKey":69,
  "type": "request",
  "listeners": ["broker"],
  "name": "DescribeTopicRequest",
  "validVersions": "0",
  "flexibleVersions": "0+",
  "fields": [
    { "name": "Topics", "type": "[]TopicRequest", "versions": "0+",
      "about": "The topics to fetch details for.", "versions": "0+", "entityType": "topicRequest",
      "fields": [
      { "name": "Partitions", "type": "[]int32", "default": "null", "versions": "0+", "nullableVersions": "0+",
        "about": "The partitions to fetch details for."},
      { "name": "FirstPartitionId", "type": "int32", "default": "-21", "versions": "0+", 
        "about": "The first partition to fetch details for. -2 means do not fetch the following partitions, -1 means to fetch all partitions,
                 others mean to fetch the partitions with and after this index."}
    ]}
]
}

...