更新时间:2025-12-10 GMT+08:00

查询用户/角色拥有权限

功能介绍

查询用户/角色拥有权限。

调用方法

请参见如何调用API。

URI

GET /v1/{project_id}/clusters/{cluster_id}/db-manager/users/{name}/authority

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

cluster_id

是

String

参数解释:

集群ID。获取方法请参见获取集群ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

name

是

String

参数解释:

用户名、角色名。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

参数解释:

分页偏移量,从0开始,页数减1。

约束限制:

不涉及。

取值范围:

大于等于0。

默认取值:

0

limit

否

Integer

参数解释:

分页单页大小。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

1000

请求参数

无

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

authority_list

Array of GrantAuthority objects

参数解释:

权限详情列表。

取值范围:

不涉及。

count

Integer

参数解释:

权限总条数。

取值范围:

不涉及。

表4 GrantAuthority

参数

参数类型

描述

type

String

参数解释:

权限类型。

取值范围:

不涉及。

database

String

参数解释:

数据库名称。

取值范围:

不涉及。

schema

String

参数解释:

模式名称。

取值范围:

不涉及。

obj_name

String

参数解释:

对象名称。

取值范围:

不涉及。

all_object

Boolean

参数解释:

是否所有对象生效。

取值范围:

不涉及。

future

Boolean

参数解释:

是否对未来对象生效。

取值范围:

不涉及。

future_object_owners

String

参数解释:

未来对象-所属用户。

取值范围:

不涉及。

column_name

Array of strings

参数解释:

列名。

取值范围:

不涉及。

privileges

Array of Grant objects

参数解释:

权限。

取值范围:

不涉及。

表5 Grant

参数

参数类型

描述

permission

String

参数解释:

权限名称,根据不同数据库对象类型,拥有权限不同。

取值范围:

  • database:CREATE | CONNECT | TEMPORARY | TEMP ALL PRIVILEGES

  • schema:CREATE | USAGE | ALTER | DROP ALL PRIVILEGES

  • table:SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER | ANALYZE | ANALYSE | VACUUM | ALTER | DROP ALL PRIVILEGES

  • view:SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER | ANALYZE | ANALYSE | VACUUM | ALTER | DROP ALL PRIVILEGES

  • column:SELECT | INSERT | UPDATE | REFERENCES ALL PRIVILEGES

  • function:EXECUTE ALL PRIVILEGES

  • sequence:SELECT | UPDATE | USAGE ALL PRIVILEGES

  • nodegroup:CREATE | USAGE | COMPUTE ALL PRIVILEGES

  • role:role_name(角色名称)

grant_with

Boolean

参数解释:

是否包含授权选项。

取值范围:

不涉及。

请求示例

查询user1用户的权限信息。

GET https://{Endpoint}/v1/05f2cff45100d5112f4bc00b794ea08e/clusters/cc6588d6-8301-4c9a-b0c0-186bb824e8c0/db-manager/users/user1/authority

响应示例

状态码:200

查询用户/角色列表成功。

{
  "authority_list" : [ {
    "type" : "DATABASE",
    "database" : "gaussdb",
    "schema" : null,
    "obj_name" : null,
    "all_object" : false,
    "future" : false,
    "future_object_owners" : null,
    "column_name" : null,
    "privileges" : [ {
      "permission" : "CREATE",
      "grant_with" : false
    }, {
      "permission" : "TEMPORARY",
      "grant_with" : false
    }, {
      "permission" : "CONNECT",
      "grant_with" : false
    } ]
  } ],
  "count" : 2
}

状态码

状态码

描述

200

查询用户/角色列表成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

417

服务内部错误。

500

服务内部错误。