最近更新时间:2024.03.06 16:49:22
首次发布时间:2023.07.12 16:22:34
调用 DescribeTopiGroups 接口获取 Topic 的 Group 信息。
请求频率:该接口请求频率限制为 100 次/秒;单用户请求频率限制为 20 次/秒。
此接口用于查看指定 Topic 的 Group 信息,包括消费模式、订阅模式等。
参数 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|
InstanceId | String | 是 | rocketmq-cnai1f0c29ca**** | 实例 ID。 |
PageNumber | Integer | 是 | 1 | 列表的页码,最小值为 1。 |
PageSize | Integer | 是 | 10 | 列表中每一页的条目数量,取值范围为 1~100。 |
TopicName | String | 是 | Name | Topic 名称,设置此参数表示根据指定的 Topic 名称进行筛选,支持模糊匹配。 |
GroupIds | Array of String | 否 | ["GID_test","GID_test1"] | Group ID,若未指定,表示查看所有 Group 信息。 |
参数 | 参数类型 | 示例值 | 说明 |
---|---|---|---|
Total | Integer | 1 | 符合查询条件的 Group 总数。 |
GroupsInfo | Array of BasicGroupInfoForTopic | / | 符合查询条件的Group列表。详细信息请参考 BasicGroupInfoForTopic。 |
POST /?Action=DescribeTopicGroups&Version=2023-01-01 HTTP/1.1 Content-Type: application/json Host: rocketmq.volcengineapi.com X-Date: 20210328T100802Z Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-shanghai/rocketmq/request, SignedHeaders=x-date, Signature=******** { "InstanceId": "rocketmq-cnai81fd122a****", "TopicName": "test", "PageSize": 10, "PageNumber": 1, "GroupIds": ["GID_test"] }
{ "ResponseMetadata": { "RequestId": "20230508195447ADBE665727867A4855CF", "Action": "DescribeTopicGroups", "Version": "2023-01-01", "Service": "RocketMQ", "Region": "cn-shanghai" }, "Result": { "GroupsInfo": [ { "GroupId": "GID_test", "MessageModel": "Clustering", "SubString": "*" } ], "Total": 1 } }