文档首页/ 分布式消息服务Kafka版/ API参考(巴黎区域)/ API V2（推荐）/ 用户管理/ 查询用户权限
更新时间：2026-01-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询用户权限

功能介绍

查询用户权限。

Kafka实例开启SASL功能时，才支持多用户管理的功能。

URI

GET /v1/{project_id}/instances/{instance_id}/topics/{topic_name}/accesspolicy

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

instance_id

是

String

实例ID。

topic_name

是

String

Topic名称。

请求参数

无

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

name

String

topic名称。

topic_type

Integer

topic类型。

policies

Array of PolicyEntity objects

权限列表。
表3 PolicyEntity

参数

参数类型

描述

owner

Boolean

是否为创建topic时所选择的用户。

user_name

String

用户名。

access_policy

String

权限类型。

  • all：拥有发布、订阅权限;

  • pub：拥有发布权限;

  • sub：拥有订阅权限。

请求示例

查询Topic的用户权限。

GET https://{endpoint}/v1/{project_id}/instances/{instance_id}/topics/{topic_name}/accesspolicy

响应示例

状态码： 200

查询成功。

{
  "name" : "topic-test",
  "policies" : [ {
    "owner" : false,
    "user_name" : "xxxa",
    "access_policy" : "pub"
  }, {
    "owner" : false,
    "user_name" : "root",
    "access_policy" : "all"
  } ],
  "topic_type" : 0
}

状态码

状态码

描述

200

查询成功。

错误码

请参见错误码。

父主题： 用户管理