Querying a Topic

Function

This API is used to query a topic.

URI

GET /v2/{project_id}/instances/{instance_id}/topics/{topic}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.
topic	Yes	String	Topic name.

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
name	String	Topic name.
total_read_queue_num	Number	Total number of read queues.
total_write_queue_num	Number	Total number of write queues.
permission	String	Permissions.
brokers	Array of brokers objects	Associated brokers.
message_type	String	Message type (available only for RocketMQ 5.x instances).

**Table 3** brokers
Parameter	Type	Description
broker_name	String	Broker name.
read_queue_num	Number	Number of read queues.
write_queue_num	Number	Number of write queues.

Example Requests

Querying details about a specified topic

GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/topics/{topic}

Example Responses

Status code: 200

Topic queried successfully.

{
  "total_read_queue_num" : 3,
  "total_write_queue_num" : 3,
  "permission" : "all",
  "brokers" : [ {
    "broker_name" : "broker-0",
    "read_queue_num" : 3,
    "write_queue_num" : 3
  } ],
  "message_type" : "NORMAL"
}