文档中心

云数据库 veDB MySQL 版

账号管理

CreateDBAccount - 创建数据库账号

CreateDBAccount - 创建数据库账号

调用 CreateDBAccount 接口创建数据库账号。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	vedbm-r3xq0zdl****	实例 ID。说明您可以调用 DescribeDBInstances 接口查询实例 ID。
AccountName	String	是	testuser1	数据库账号名称。账号名称需满足以下要求：名称唯一，且长度在 2~32 个字符内。由字母、数字、中划线（-）、下划线（_）组成。以字母开头，以字母或数字结尾。名称内不能包含某些禁用词，详细信息请参见禁用关键词。且不能使用某些预留字，例如 root、admin 等。
AccountPassword	String	是	Test@123	数据库账号的密码。账号密码需满足以下要求：只能包含大小写字母、数字及以下特殊字符 ~!@#$%^&*_-+=`\|\(){}[]:;'<>,.?/。长度需在 8~32 个字符内。至少包含大写字母、小写字母、数字或特殊字符中的 3 种。
AccountType	String	是	Normal	数据库账号类型，取值： Super：高权限账号，一个实例只能创建一个高权限账号，且具备该实例下所有数据库所有权限，可以管理所有普通账号和数据库。 Normal：一个实例可以创建多个普通账号，需要手动给普通账号授予特定数据库的权限。
AccountDesc	String	否	这是一段账号的描述信息	账号的描述信息，描述内容长度为 0~256 个字符。可以包含数字、中文、英文、下划线（_）和中划线（-）。
AccountPrivileges	Array of AccountPrivilegeObject	否	请参见请求示例。	数据库的权限信息。说明当 AccountType 取值为 Super时，无需传入该参数，高权限账号默认具备该实例下所有数据库的所有权限。当 AccountType 取值为 Normal时，建议传入该参数，为普通账号授予指定数据库的指定权限。不设置时，该账号不具备任何数据库的任何权限。

AccountPrivilegeObject

参数	类型	是否必选	示例值	描述
DBName	String	是	db1	需授权的数据库名称。
AccountPrivilege	String	是	ReadWrite	授权数据库权限类型： ReadWrite：读写权限。 ReadOnly：只读权限。 DDLOnly：仅 DDL 权限。 DMLOnly：仅 DML 权限。 Custom：自定义权限。
AccountPrivilegeDetail	String	否	INSERT,UPDATE,DELETE,CREATE	权限类型所包含的具体 SQL 操作权限，多个字符串之间使用英文逗号（,）分隔。在 CreateDBAccount 和 GrantDBAccountPrivilege 接口中作为请求参数时，当 AccountPrivilege 取值为 Custom 时，该参数必填。取值范围（可多选）：SELECT、INSERT、UPDATE、DELETE、CREATE、DROP、REFERENCES、INDEX、ALTER、CREATE TEMPORARY TABLES、LOCK TABLES、EXECUTE、CREATE VIEW、SHOW VIEW、CREATE ROUTINE、ALTER ROUTINE、EVENT、TRIGGER。在 DescribeDBAccounts 接口中作为返回参数时，无论 AccountPrivilege 取什么值，都返回该权限类型所包含的 SQL 操作权限详情。关于各权限类型包含的具体 SQL 操作权限请参见账号权限列表。

返回参数

null

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.02.25 13:20:54

这个页面对您有帮助吗？

有用

有用

无用

无用