文档中心

云数据库 veDB MySQL 版

账号管理

DescribeDBAccounts - 获取数据库账户列表

DescribeDBAccounts - 获取数据库账户列表

调用 DescribeDBAccounts 接口查询实例的账号信息。

请求类型

同步请求。

调试

API Explorer

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

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	vedbm-r3xq0zdl****	实例 ID。说明您可以调用 DescribeDBInstances 接口查询实例 ID。
PageSize	Integer	否	10	每页记录数。取值范围 1~1000，默认值为 10。
PageNumber	Integer	否	1	页码。取值大于等于 1，且不超过 Integer 的最大值，默认值为 1。
AccountName	String	否	testuser1	数据库账号名称，支持模糊查询。说明通过 SQL 创建的不符合命名规范的账号，支持通过 API 修改和删除，但无法通过指定该参数精准查询。

返回参数

参数	类型	示例值	描述
Total	Integer	1	账号总数。
Accounts	Array of AccountObject	请参见返回示例。	账号列表。

AccountObject

参数	类型	示例值	描述
AccountName	String	testuser	账号名称。
AccountType	String	Normal	账号类型： Super：高权限账号。 Normal：普通账号。
AccountDesc	String	这是一段账号的描述信息	账号的描述信息。
AccountPrivileges	Array of AccountPrivilegeObject	请参见返回示例。	账号的权限信息。

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 操作权限请参见账号权限列表。

示例

请求示例

返回示例

错误码

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

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

这个页面对您有帮助吗？

有用

有用

无用

无用