更新时间:2024-09-11 GMT+08:00

查询数据库账户

功能介绍

查询数据库账户。

URI

GET /v3/{project_id}/instances/{instance_id}/clickhouse/users

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一Region下的project ID。

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

instance_id

String

ClickHouse实例ID,严格匹配UUID规则。

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

查询记录数,默认10。不能为负数,最小值为1,最大值为100。

offset

Integer

索引位置,偏移量。默认0。从第一条数据偏移offset条数据后开始查询(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。

user_name

String

数据库账户。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

String

请求语言类型。默认en-us。

取值范围:

  • en-us
  • zh-cn

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

user_details

Array of user_details objects

数据库账户信息。

total_count

Integer

数据库账户数量。

表5 user_details

参数

参数类型

描述

user_name

String

数据库账户名。

databases

Array of strings

已授权数据库。

dml

Integer

DML权限。 取值范围:

  • 1:只读权限
  • 2:读取和设置权限

ddl

Integer

DDL授权。 取值范围:

  • 0:无DDL权限
  • 1:有DDL权限

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码: 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

查询数据库10个账号信息。

GET https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/instances/54e42160670e48e789af7075e1efea1fin16/clickhouse/users?limit=10

响应示例

状态码: 200

Success.

{
  "user_details" : [ {
    "user_name" : "root",
    "databases" : [ "*" ],
    "dml" : 2,
    "ddl" : 0
  }, {
    "user_name" : "user_test1",
    "databases" : [ "*" ],
    "dml" : 2,
    "ddl" : 0
  } ],
  "total_count" : 2
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码