查询权限列表
所有文档
menu

消息服务 for Kafka

查询权限列表

产品详情立即开通

该接口用于查询集群的权限列表。

  • 使用该接口时集群需要开启权限管理。

请求结构

GET /v{version}/clusters/{clusterId}/acls HTTP/1.1
Host: kafka-api.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其他特殊头域。

请求参数

参数名称 类型 是否必须 参数位置 描述
version String URL参数 API版本号
clusterId String URL参数 待查询的集群ID
username String Query参数 权限的用户名称,用于查询匹配
patternType String Query参数 权限的匹配模式,用于查询匹配,具体可选模式参见AclPatternType
resourceType String Query参数 权限的资源类型,用于查询匹配,具体可选类型参见AclResourceType
resourceName String Query参数 权限的资源名称,用于查询匹配

返回头域

除公共头域外,无其他特殊头域。

返回参数

参数名称 类型 描述
acls List<Acl> 权限信息列表,由 Acl 组成的集合

错误码

错误码 错误描述 HTTP状态码 描述
ERROR_PARAMS 请求参数错误 400 请求参数错误
CLUSTER_NOT_FOUND 集群不存在 451 集群不存在
CLUSTER_HAD_DELETED 集群已删除 451 集群已删除
CLUSTER_NOT_BELONGED 未拥有该集群 451 未拥有该集群
CLUSTER_ACL_NOT_ENABLED 集群未开启权限管理 451 集群未开启权限管理
INTERNAL_ERROR 服务内部错误 500 服务内部错误

请求示例

GET http://kafka-api.bj.baidubce.com/v2/clusters/33a168bb70c0459787416077114ab233/acls
Authorization: bce-auth-v1/ALTAKaiKeDfBD880eMWBE5oIGE/2023-05-08T11:43:45Z/1800/host;x-bce-date/322f3f98ce57d296c0f5abc64e5554b640ea035c5cb462fcaeab54b9810a3c61
Host: kafka-api.bj.baidubce.com

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 97e6d4ad-6fca-4609-ad4d-9a27c4d1a362
Date: Mon, 08 May 2023 09:39:11 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "acls": [
        {
            "username": "user",
            "patternType": "LITERAL",
            "resourceType": "TOPIC",
            "resourceName": "test_topic",
            "operation": "PRODUCE"
        },
        {
            "username": "user",
            "patternType": "LITERAL",
            "resourceType": "TOPIC",
            "resourceName": "test_topic",
            "operation": "CONSUME"
        },
        {
            "username": "user",
            "patternType": "LITERAL",
            "resourceType": "GROUP",
            "resourceName": "test_group",
            "operation": "CONSUME"
        }
    ]
}
上一篇
删除权限
下一篇
集群配置接口