Querying the Number of Messages in a Topic_Topic Management_APIs V2 (Recommended)_API Reference (Kuala Lumpur Region)_Distributed Message Service for RocketMQ-Huawei Cloud

Function

This API is used to query the number of messages in a topic.

URI

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

**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
max_offset	Integer	Maximum offset.
min_offset	Integer	Minimum offset.
brokers	Array of brokers objects	Brokers.

**Table 3** brokers
Parameter	Type	Description
queues	Array of queues objects	Queue list.
broker_name	String	Broker name.

**Table 4** queues
Parameter	Type	Description
id	Integer	Queue ID.
min_offset	Integer	Minimum offset.
max_offset	Integer	Maximum offset.
last_message_time	Long	Time of the last message.

Example Requests

Querying the number of messages in a specified topic

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

Example Responses

Status code: 200

The number of messages in the topic queried successfully.

Successful.

{
  "brokers" : {
    "queues" : [ {
      "id" : 0,
      "min_offset" : 0,
      "max_offset" : 2,
      "last_message_time" : 1662689877152
    } ],
    "broker_name" : "broker-0"
  }
}

Status Codes

Status Code	Description
200	The number of messages in the topic queried successfully.

Error Codes

See Error Codes.

Querying the Number of Messages in a Topic