使用 OnsTopicStatus 查询当前 Topic 下的消息总量以及 Topic 的最后更新时间。

本接口一般用于判断 Topic 资源的使用率。调用本接口后返回的信息包含当前服务器上该 Topic 所有的消息数,以及最后消息写入时间。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String OnsTopicStatus

系统规定参数。取值:OnsTopicStatus。

InstanceId String MQ_INST_111111111111_DOxxxxxx

需查询的 Topic 所对应的实例 ID。

Topic String test

需查询的 Topic 名称。

返回数据

名称 类型 示例值 描述
Data Struct

查询到的 Topic 的信息存储数据结构。

LastTimeStamp Long 1570864984364

当前 Topic 的最后更新时间。

Perm Integer 6

所有关系编号。取值说明如下:

  • 2:可以发布
  • 4:可以订阅
  • 6:可以发布和订阅
TotalCount Long 2310

当前 Topic 的所有分区存在的消息数总和。

RequestId String 427EE49D-D762-41FB-8F3D-9BAC96C314B4

为公共参数,每个请求的 ID 都是唯一的。

示例

请求示例

http(s)://[Endpoint]/?Action=OnsTopicStatus
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Topic=test
&<公共请求参数>

正常返回示例

XML 格式

<OnsTopicStatusResponse>
  <Data>
        <Perm>6</Perm>
        <TotalCount>2310</TotalCount>
        <LastTimeStamp>1570864984364</LastTimeStamp>
  </Data>
  <RequestId>427EE49D-D762-41FB-8F3D-9BAC96C314B4</RequestId>
</OnsTopicStatusResponse>

JSON 格式

{
	"Data": {
		"Perm": 6,
		"TotalCount": 2310,
		"LastTimeStamp": 1570864984364
	},
	"RequestId": "427EE49D-D762-41FB-8F3D-9BAC96C314B4"
}

错误码

访问错误中心查看更多错误码。