查询数据库列表
功能介绍
查询指定实例中的数据库列表。
- 调用接口前,您需要了解API 认证鉴权。
调试
您可以在API Explorer中调试该接口。
接口约束
- 实例在异常或冻结状态下不能执行该操作。
- 不支持查询只读实例的数据库列表。
URI
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
instance_id
是
实例ID。
db
否
数据库名称,忽略大小写模糊查询。
page
是
分页页码,从1开始。
limit
是
每页数据条数。取值范围[1, 100]。
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
databases
Array of objects
列表中每个元素表示一个数据库。
详情请参见表3。
total_count
Integer
数据库总数。
- 正常响应样例
{ "databases": [ { "name": "rds_test", "owner": "root", "character_set": "UTF8", "collate_set":"en_US.UTF-8", "size":10777247, "comment":"comment" }, { "name": "rds_test2", "owner":"root", "character_set": "UTF8", "collate_set":"en_US.UTF-8", "size":1055623, "comment":"comment" }, { "name": "rds_test3", "owner":"root", "character_set": "UTF8", "collate_set":"en_US.UTF-8", "size":107772488, "comment":"comment" } ], "total_count": 3 }
- 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。