消息队列 CKafka 版枚举 ACL 策略-API 文档-文档中心-腾讯云

说明：

该功能目前处于灰度测试阶段，如需要在控制台试用，请通过提交内测申请的方式开通白名单。

1. 接口描述

接口请求域名：ckafka.api.qcloud.com
本接口（ListAcl）用于枚举实例的 ACL 策略。

2. 输入参数

以下请求参数列表仅列出了接口请求参数，其它参数见公共请求参数页面。

参数名称	必选	类型	描述
instanceId	是	String	实例 ID
resourceType	是	Int	ACL 资源类型，（0：UNKNOWN，1：ANY，2：TOPIC，3：GROUP，4：CLUSTER，5：TRANSACTIONAL_ID）
resourceName	是	String	资源名称，和 resourceType 相关，如当 resourceType 为 TOPIC 时，则该字段表示 topic 名称，当 resourceType 为 GROUP 时，该字段表示 group 名称
searchWord	否	String	（过滤条件）按照资源名称过滤，支持模糊查询
offset	否	String	偏移量，不填默认为0
limit	否	String	返回数量，不填则默认10，最大值20

3. 输出参数

参数名称	类型	描述
acls	Array	ACL 策略的列表
acls::resourceType	Int	ACL 资源类型，（0：UNKNOWN，1：ANY，2：TOPIC，3：GROUP，4：CLUSTER，5：TRANSACTIONAL_ID）
acls::resourceName	String	资源名称，和 resourceType 相关，如当 resourceType 为 TOPIC 时，则该字段表示 topic 名称，当 resourceType 为 GROUP 时，该字段表示 group 名称
acls::operation	Int	ACL 操作方式，（0：UNKNOWN，1：ANY，2：ALL，3：READ，4：WRITE，5：CREATE，6：DELETE，7：ALTER，8：DESCRIBE，9：CLUSTER_ACTION，10：DESCRIBE_CONFIGS，11：ALTER_CONFIGS，12:IDEMPOTEN_WRITE）
acls::permissionType	Int	权限类型（0：UNKNOWN，1：ANY，2：DENY，3：ALLOW）
acls::host	String	ACL 策略作用的主机 IP
acls::principal	Int	ACL 关联的用户列表

4. 示例

输入：

 https://domain/v2/index.php?Action=ListAcl
  &instanceId=ckafka-tadfqa0
  &resourceType=2
  &resourceName=test-topic
  &<公共请求参数>

输出：

{
"code":0,
"message":"",
"codeDesc":"Success",
"data":{
 "acls":[
  {
   "resourceType":2,
   "resourceName":"topic-a",
   "host":"*",
   "permissionType":3,
   "operation":3,
   "principal":"User:anonymous"
  },
  {
   "resourceType":2,
   "resourceName":"topic-a",
   "host":"*",
   "permissionType":3,
   "operation":3,
   "principal":"User:blob"
  }
 ]
}
}

枚举 ACL 策略

本页目录：

1. 接口描述

2. 输入参数

3. 输出参数

4. 示例