文档中心 > DescribeDatabases
DescribeDatabases

最近更新时间:2022-01-18

请求路径:/api/rds

请求方法:GET

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

请求参数

名称

类型

是否必选

示例值

描述

Action

String

DescribeDatabases

系统规定参数。取值:DescribeDatabases。

DBInstanceId

String

mysql-lv1xxxxxxx

数据库实例ID。

PageSize

Integer

10

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

PageNumber

Integer

1

分页参数,当前页。

返回参数

状态码:200

名称

类型

示例值

描述

RequestId

String

rm-uf6wjk5xxxxxxxxxx

请求ID。

PageNumber

Integer

1

当前页。

PageSize

Integer

30

每页数据库个数。

TotalRecordCount

Integer

100

总记录数。

TotalPageCount

Integer

3

总页数。

Items

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/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": [
              {
                   "AccountName": "test1",
                   "AccountPrivilege": "DBOwner"
              },
              {
                   "AccountName": "test1112",
                   "AccountPrivilege": "readWrite"
              }
          ]
      },
      {
           "DBName": "testdb1",
           "DBStatus": "running",
           "CharacterSetName": "utf8mb4",
           "Accounts": [
              {
                   "AccountName": "test1",
                   "AccountPrivilege": "DBOwner"
              },
              {
                   "AccountName": "test1112",
                   "AccountPrivilege": "DBOwner"
              }
          ]
      }
  ]
}