文档首页> 分布式消息服务RocketMQ版> API参考（吉隆坡区域）> API V2（推荐）> Topic管理> 查询主题的消息数
更新时间：2024-04-08 GMT+08:00
在线调试
CLI示例
查看PDF

查询主题的消息数

功能介绍

查询主题的消息数。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方式请参见获取项目ID。

instance_id

是

String

实例ID。

topic

是

String

主题名称。

请求参数

无

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

max_offset

Integer

最大偏移量。

min_offset

Integer

最小偏移量。

brokers

Array of brokers objects

代理。
表3 brokers

参数

参数类型

描述

queues

Array of queues objects

队列列表。

broker_name

String

节点名称。
表4 queues

参数

参数类型

描述

id

Integer

队列ID。

min_offset

Integer

最小偏移量。

max_offset

Integer

最大偏移量。

last_message_time

Long

最后一条消息的时间。

请求示例

查询指定主题的消息数。

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

响应示例

状态码： 200

查询主题的消息数成功。

  • 查询主题的消息数成功。

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

状态码

状态码

描述

200

查询主题的消息数成功。

错误码

请参见错误码。

父主题： Topic管理