ListTopicPermissions--消息队列 RocketMQ版-火山引擎

文档中心

立即注册

导航

ListTopicPermissions

最近更新时间：2024.03.06 16:49:21首次发布时间：2021.08.30 16:57:44

调用 ListTopicPermissions 接口查看指定 Topic 在各个 RocketMQ 密钥中的自定义权限。

注意事项

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

使用说明

该接口从 Topic 角度查看密钥的权限，即查看所有对于此 Topic 有自定义权限的 RocketMQ 密钥列表，并查看其对应权限。

请求参数

参数	参数类型	是否必选	示例值	说明
InstanceId	String	必选	MQ_INST_********	实例 ID。
Topic	String	必选	newtopic	Topic 名称。
Offset	Integer	必选	1	列表页码。
Limit	Integer	必选	10	分页大小。
SortField	String	必选	Name	列表排序方式。支持根据以下方式排序： CreatedTime：创建时间。
SortOrder	String	必选	Acs	列表排序类型。支持设置为： Asc：升序排列。 Desc：降序排列。

响应参数

参数	参数类型	说明
Permissions	Array of AuthKeyPermission	对于此 Topic 有自定义权限的 RocketMQ 密钥列表。详细说明请参考 AuthKeyPermission。
Total	Integer	对于此 Topic 有自定义权限的 RocketMQ 密钥总数。

示例

请求示例

POST https://rocketmq.volcengineapi.com/?Action=ListTopicPermissions&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_********",
  "Topic": "new",
  "Offset": 1,
  "Limit": 10,
  "SortField": "Name",
  "SortOrder": "Asc"
}

响应示例

{
  "ResponseMetadata": {
    "RequestId": "*********************",
    "Action": "ListTopicPermissions",
    "Version": "2021-04-01",
    "Service": "rocketmq",
    "Region": "cn-beijing"
  },
  "Result": {
    "Permissions": [
      {
        "Ak": "ak****",
        "Permission": "DENY"
      }
    ],
    "Total": 1
  }
}