更新时间：2025-10-14 GMT+08:00
创建数据库用户
接口说明
给指定实例创建数据库用户。
约束说明
- 该接口只支持DDS社区版。
- 实例在创建、规格变更、修改端口、冻结、重启等过程中以及状态为非“normal”时，不允许执行该操作。
调试
您可以在API Explorer中调试该接口。
URI
|
名称 |
是否必选 |
类型 |
IN |
描述 |
|---|---|---|---|---|
|
project_id |
是 |
string |
path |
参数解释： 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
instance_id |
是 |
string |
path |
参数解释： 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求消息
|
名称 |
是否必选 |
类型 |
IN |
描述 |
|---|---|---|---|---|
|
X-Auth-Token |
是 |
string |
header |
参数解释： 从IAM服务获取的用户Token。请参考认证鉴权。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
名称 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|
|
user_name |
String |
是 |
数据库用户名称。
|
|
user_pwd |
String |
是 |
数据库用户密码。
|
|
roles |
Array of Object |
是 |
新用户所拥有的角色。请参见表4。 roles限制了该账户所具有的权限。若指定一个空数组，表示该账户不具有任何权限。 |
|
db_name |
String |
否 |
新用户所在的数据库，默认为“admin”。 取值范围：长度为1~64位，可以包含大写字母（A~Z）、小写字母（a~z）、数字（0~9）、下划线。 |
请求示例
创建指定实例test的用户testDb
{
"user_name":"test" ,
"user_pwd":"******",
"roles":[{
"role_db_name":"testDb" ,
"role_name":"testRole"
}],
"db_name":"test_db"
}
响应消息
- 响应示例
{}
SDK
单击文档数据库服务 DDS SDK，下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
状态码
详情请参见状态码。
错误码
详情请参见错误码。
父主题： 管理数据库和用户
