更新时间:2025-09-18 GMT+08:00

修改指定用户信息

功能介绍

修改指定用户信息。

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

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

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

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

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

name

String

参数解释

用户名/角色名称。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

login

Boolean

参数解释

是否可以登录。

取值范围

不涉及。

createrole

Boolean

参数解释

创建角色权限。

取值范围

不涉及。

createdb

Boolean

参数解释

创建数据库权限。

取值范围

不涉及。

systemadmin

Boolean

参数解释

系统管理员。

取值范围

不涉及。

auditadmin

Boolean

参数解释

审计管理员。

取值范围

不涉及。

inherit

Boolean

参数解释

继承所在组权限。

取值范围

不涉及。

useft

Boolean

参数解释

访问外表权限。

取值范围

不涉及。

conn_limit

Integer

参数解释

连接数限制。

取值范围

不涉及。

replication

Boolean

参数解释

是否允许流复制。

取值范围

不涉及。

valid_begin

String

参数解释

角色生效时间。格式:yyyy-MM-ddTHH:mm:ssZ。

取值范围

不涉及。

valid_until

String

参数解释

角色过期时间。格式:yyyy-MM-ddTHH:mm:ssZ。

取值范围

不涉及。

lock

Boolean

参数解释

是否锁定。

取值范围

不涉及。

响应参数

状态码:200

修改成功。

请求示例

修改集群ID为“a89aea88-7ea2-40bd-8ac8-8b93e169e5d6”下的用户user1的用户信息。即可以登录数据库并拥有创建角色、创建数据库、访问外表权限,但不赋予给用户系统管理员和审计管理员权限,并不限制连接数等。

POST https://{Endpoint}/v1/0536cdee2200d5912f7cc00b877980f1/clusters/a89aea88-7ea2-40bd-8ac8-8b93e169e5d6/db-manager/users/user1

{
  "login" : true,
  "createrole" : true,
  "createdb" : true,
  "systemadmin" : false,
  "auditadmin" : false,
  "inherit" : false,
  "useft" : true,
  "conn_limit" : -1,
  "replication" : false,
  "valid_begin" : "2023-04-03T12:23:01",
  "valid_until" : "2023-04-18T12:23:01",
  "lock" : false
}

响应示例

状态码

状态码

描述

200

修改成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。