备案 控制台 登录 注册
文档中心 > DescribeDatabases
DescribeDatabases

最近更新时间：2022-09-26

请求路径：/v3/api/rds

请求方法：GET

接口描述：查询数据库列表

请求参数

名称

类型

是否必选

示例值

描述

Action

String

是

DescribeDatabases

系统规定参数。取值：DescribeDatabases

DBInstanceId

String

是

mysql-lv1xxxxxxx

数据库实例ID

PageSize

Integer

否

10

分页参数，每页大小,默认30

PageNumber

Integer

否

1

分页参数，当前页

DBName

String

否

testdb1

数据库名称

返回参数

状态码：200

名称

类型

示例值

描述

RequestId

String

rm-uf6wjk5xxxxxxxxxx

请求ID

PageNumber

Integer

1

当前页

PageSize

Integer

30

每页数据库个数

TotalCount

Integer

100

总记录数

TotalPage

Integer

3

总页数

Records

Array

[]

由数据库信息组成的数组

-   DBName

String

db1

数据库名称

-   DBStatus

String

running

数据库状态

- CharacterSetName

String

utf8

字符集

-   Accounts

Array

[]

当前数据库的账号权限信息组成的数组

--   AccountName

String

user1

账号名称

--   AccountPrivilege

String

readOnly

账号权限:

  • readOnly：只读

  • readWrite：读写

  • DBOwner：数据库所有者

示例

请求示例

GET https://api.unicloud.com/v3/api/rds?

Action=DescribeDatabases

&DBInstanceId=mysql-xxxxxxxxxxx

返回示例

{

"PageNumber": 1,

"PageSize": 30,

"TotalRecordCount": 2,

"TotalPageCount": 1,

"RequestId": "b9de1a62-d09e-4d34-9a61-38f0f56564b6",

"Items": [

         {

                  "DBName": "testdb",

                  "DBStatus": "running",

                  "CharacterSetName": "utf8",

                  "Accounts": null

         },

         {

                  "DBName": "testdb1",

                  "DBStatus": "running",

                  "CharacterSetName": "utf8",

                  "Accounts": null

         }

]

}