docs
api
Kafka(UKafka)
ListUKafkaTopics

List Kafka cluster topics - ListUKafkaTopics

Overview

Display all topics on the Kafka cluster

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is ListUKafkaTopics.Yes
PublicKeystringThe user's public key can be obtained from Console (opens in a new tab)Yes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
RegionstringRegion. See List of Regions and Availability ZonesYes
ZonestringAvailability Zone. See Availability Zone ListYes
ProjectIdstringProject ID. If not filled in, the default project is used, and the sub-account must be filled in. Please refer to the GetProjectList interface.No
ClusterInstanceIdstringCluster Resource IDYes

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
TopicListarray[TopicInfo]Topic Information ListYes
LengthintList LengthNo

Data Model

TopicInfo

Field NameTypeDescription InformationRequired
Topicstringtopic nameNo
NumOfPartitionintNumber of PartitionsNo
NumOfOccupyBrokerintNumber of brokers occupiedNo
NumOfReplicaintNumber of ReplicasNo
UnderReplicasPerfloatLagging Replica ProportionNo
Statusstringtopic statusNo

Example

Request Example

https://api.surfercloud.com/?Action=ListUKafkaTopics
&Zone=cn-zj-02
&ClusterInstanceId=ukafka-asje3q
&Region=cn-zj
&ProjectId=qVHhqxTv

Response Example

{
  "Action": "ListTopicsResponse",
  "Length": 3,
  "RetCode": 0,
  "TopicList": [
    {
      "allIsr": 9,
      "allReplicas": 9,
      "numOfOccupyBroker": 3,
      "numOfPartition": 3,
      "numOfReplica": 3,
      "topic": "nil",
      "underReplicasPer": 0
    },
    {
      "allIsr": 9,
      "allReplicas": 9,
      "numOfOccupyBroker": 3,
      "numOfPartition": 3,
      "numOfReplica": 3,
      "topic": "foo",
      "underReplicasPer": 0
    },
    {
      "allIsr": 3,
      "allReplicas": 3,
      "numOfOccupyBroker": 3,
      "numOfPartition": 1,
      "numOfReplica": 3,
      "topic": "bar",
      "underReplicasPer": 0
    }
  ]
}
  • Company
  • ContactUs
  • Blog
Copyright © 2024 SurferCloud All Rights Reserved