全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云数据库 RDS 版

DescribeDatabases

更新时间:2018-04-28 18:03:19

描述

该接口用于查找指定实例、指定DB的DB列表信息。如果查找参数类型错误,将返回错误提示,返回数据为空。

注意:此接口不支持PostgreSQL和PPAS。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值为DescribeDatabases。
DBInstanceId String 实例名。
DBName String 数据库名称。
DBStatus String 数据库状态,取值范围:
  • Creating:创建中;
  • Running:使用中;
  • Deleting:删除中。

返回参数

名称 类型 描述
<公共返回参数> 详见公共参数
Databases List<Database> 由Database组成的数据。

DATABASE参数

名称 类型 描述
DBName String 数据库名称。
DBInstanceId String 数据库所属实例名称。
Engine String 数据库实例类型。
DBStatus String 数据库状态,取值范围:
  • Creating:创建中;
  • Running:使用中;
  • Deleting:删除中。
CharacterSetName String 字符集。
DBDescription String 数据库描述。
Accounts List<AccountPrivilegeInfo> 由Acounts组成的list。
Account String 账号名称。
AccountPrivilege String 账号对该DB具有的权限。

AccountPrivilegeInfo参数

名称 类型 描述
Account String 账号名称。
AccountPrivilege String 账号对该DB具有的权限。

示例

请求示例

  1. https://rds.aliyuncs.com/?Action=DescribeDatabases
  2. &DBInstanceId=rds3meynazqbzju
  3. &<公共请求参数>

返回示例

XML格式:

  1. < DescribeDatabasesResponse>
  2. <RequestId>2603CA96-B17D-4903-BC04-61A2C829CD94</RequestId>
  3. <Databases>
  4. <Database>
  5. <Engine>MySQL</Engine>
  6. <DBName>testdb</DBName>
  7. <CharacterSetName>utf8</CharacterSetName>
  8. <DBStatus>Creating</DBStatus>
  9. <DBInstanceId>rds3meynazqbzju</DBInstanceId>
  10. <Accounts>
  11. <AccountPrivilegeInfo></AccountPrivilegeInfo>
  12. <Accounts>
  13. </Database>
  14. <Database>
  15. <Engine>MySQL</Engine>
  16. <DBName>testdb2</DBName>
  17. <CharacterSetName>gbk</CharacterSetName>
  18. <DBStatus>Creating</DBStatus>
  19. <DBInstanceId>rds3meynazqbzju</DBInstanceId>
  20. <Accounts>
  21. <AccountPrivilegeInfo></AccountPrivilegeInfo>
  22. <Accounts>
  23. </Database>
  24. </Databases>
  25. </ DescribeDatabasesResponse>

JSON格式:

  1. {
  2. "RequestId": "2603CA96-B17D-4903-BC04-61A2C829CD94",
  3. "Databases": {
  4. "Database": [
  5. {
  6. "Engine": "MySQL",
  7. "CharacterSetName": "utf8",
  8. "DBStatus": "Creating",
  9. "DBDescription": "",
  10. "DBInstanceId": "rds3meynazqbzju",
  11. "Accounts": {
  12. " AccountPrivilegeInfo": []
  13. },
  14. "DBName": "testdb"
  15. },
  16. {
  17. "Engine": "MySQL",
  18. "CharacterSetName": "gbk",
  19. "DBStatus": "Creating",
  20. "DBDescription": "",
  21. "DBInstanceId": "rds3meynazqbzju",
  22. "Accounts": {
  23. " AccountPrivilegeInfo": []
  24. },
  25. "DBName": "testdb2"
  26. }
  27. ]
  28. }
  29. }
本文导读目录