更新时间:2023-11-24 GMT+08:00

创建数据库用户

接口说明

给指定实例创建数据库用户。

约束说明

  • 该接口只支持DDS社区版。
  • 实例在创建、规格变更、修改端口、冻结、重启等过程中以及状态为非“normal”时,不允许执行该操作。

URI

  • URI格式

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-user

  • URI样例

    https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/f032c0db12d147ef87317efdfacbbe15in02/db-user

表1 请求参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

从IAM服务获取的用户Token。请参考认证鉴权

project_id

string

path

租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。

instance_id

string

path

实例ID,可以调用“查询实例列表和详情”接口获取。如果未申请实例,可以调用“创建实例”接口创建。

请求消息

  • 参数说明
    表2 参数说明

    名称

    参数类型

    是否必选

    描述

    user_name

    String

    数据库用户名称。

    • 取值范围:长度为1~64位,可以包含大写字母(A~Z)、小写字母(a~z)、数字(0~9)、中划线、下划线和点。
    • 用户名不能为内部保留用户:drsFull,drsIncremental。

    user_pwd

    String

    数据库用户密码。

    • 取值范围:长度为8~32位,必须是大写字母(A~Z)、小写字母(a~z)、数字(0~9)、特殊字符~!@#%^*-_=+?的组合。
    • 建议您输入高强度密码,以提高安全性,防止出现密码被暴力破解等安全风险。

    roles

    Array of Object

    新用户所拥有的角色。请参见表3

    roles限制了该账户所具有的权限。若指定一个空数组,表示该账户不具有任何权限。

    db_name

    String

    新用户所在的数据库,默认为“admin”。

    取值范围:长度为1~64位,可以包含大写字母(A~Z)、小写字母(a~z)、数字(0~9)、下划线。

    表3 roles字段数据结构说明

    名称

    参数类型

    是否必选

    描述

    role_db_name

    String

    授予新用户所拥有的角色所在数据库名称。

    取值范围:长度为1~64位,可以包含大写字母(A~Z)、小写字母(a~z)、数字(0~9)、下划线。

    role_name

    String

    授予新用户所拥有的角色名称。

    取值范围:长度为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文档中对应语言类型的【使用】目录下。

状态码

详情请参见状态码

错误码

详情请参见错误码