You need to enable JavaScript to run this app.
导航
消息队列 RocketMQ版
  • 文档首页
    • /
  • 消息队列 RocketMQ版

ListTopics

最近更新时间：2024.03.06 16:49:21

首次发布时间：2021.08.30 16:57:44

我的收藏

调用 ListTopics 接口查看 Topic 列表。

注意事项

请求频率：该接口请求频率限制为 100 次/秒；单用户请求频率限制为 20 次/秒。

使用说明

ListTopics用户查看指定实例下的 Topic 列表，其中包含每个 Topic 的详细信息。如果只需查看指定 Topic 的详细信息，推荐使用 GetTopic 接口。

请求参数

参数

参数类型

是否必选

示例值

说明

InstanceId

String

必选

MQ_INST_********

实例 ID。

Offset

Integer

必选

0

偏移量。

Limit

Integer

必选

10

本次请求返回的条目数。

SortField

String

必选

Name

列表排序方式。支持根据以下方式排序：

  • Name：Topic名称。
  • CreatedTime：创建时间。

SortOrder

String

必选

Acs

列表排序类型。支持设置为：

  • Asc：升序排列。
  • Desc：降序排列。

响应参数

参数

参数类型

说明

Topics

Array of TopicInfo

Topic 信息。详细说明请参考 TopicInfo。

Total

Integer

Topic 总数。

示例

请求示例

POST https://rocketmq.volcengineapi.com/?Action=ListTopics&Version=2021-04-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: rocketmq.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK*********************/20210328/cn-beijing/rocketmq/request, SignedHeaders=x-date, Signature=*********************

{
  "InstanceId": "MQ_INST_********",
  "Offset": 0,
  "Limit": 10,
  "SortField": "Name",
  "SortOrder": "Asc"
  }
}

响应示例

{
  "ResponseMetadata": {
    "RequestId": "*********************",
    "Action": "ListTopics",
    "Version": "2021-04-01",
    "Service": "rocketmq",
    "Region": "cn-beijing"
  },
  "Result": {
        "Topics": [
            {
                "CreatedTime": 1649933870,
                "Description": "",
                "InstanceId": "MQ_INST_****",
                "MessageType": "Common",
                "Tags": [],
                "TopicName": "test"
            }
        ],
        "Total": 1
    }
}