API参考 - API参考 -   数据库管理 - DescribeDatabases

描述


该接口用于查找指定实例、指定DB的DB列表信息。如果查找参数类型错误，将返回错误提示，返回数据为空。
[tr=transparent] [/url]注意[tr=transparent]接口不支持PostgreSQL和PPAS。

请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数，取值为DescribeDatabases。DBInstanceIdString是实例名。DBNameString否数据库名称。DBStatusString否数据库状态，取值范围：

• Creating：创建中
• Running：使用中
• Deleting：删除中

返回参数

[tr=rgb(51, 205, 229)][td]名称 类型描述<公共返回参数>详见[url=https://help.aliyun.com/document_detail/26224.html]公共参数。DatabasesList<Database>由Database组成的数据。

DATABASE参数

[tr=rgb(51, 205, 229)][td]名称 类型描述DBNameString数据库名称。DBInstanceIdString数据库所属实例名称。EngineString数据库实例类型。DBStatusString数据库状态，取值范围：

• Creating：创建中
• Running：使用中
• Deleting：删除中

CharacterSetNameString字符集。DBDescriptionString数据库描述。AccountsList<AccountPrivilegeInfo>由Acounts组成的list。AccountString账号名称。AccountPrivilegeString账号对该DB具有的权限。

AccountPrivilegeInfo参数

[tr=rgb(51, 205, 229)][td]名称 类型描述AccountString账号名称。AccountPrivilegeString账号对该DB具有的权限。

请求示例

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

返回示例


XML格式< DescribeDatabasesResponse><RequestId>2603CA96-B17D-4903-BC04-61A2C829CD94</RequestId><Databases><Database><Engine>MySQL</Engine><DBName>testdb</DBName><CharacterSetName>utf8</CharacterSetName><DBStatus>Creating</DBStatus><DBInstanceId>rds3meynazqbzju</DBInstanceId><Accounts><AccountPrivilegeInfo></AccountPrivilegeInfo><Accounts></Database><Database><Engine>MySQL</Engine><DBName>testdb2</DBName><CharacterSetName>gbk</CharacterSetName><DBStatus>Creating</DBStatus><DBInstanceId>rds3meynazqbzju</DBInstanceId><Accounts><AccountPrivilegeInfo></AccountPrivilegeInfo><Accounts></Database></Databases></ DescribeDatabasesResponse>
JSON格式 {"RequestId": "2603CA96-B17D-4903-BC04-61A2C829CD94","Databases": {"Database": [{"Engine": "MySQL","CharacterSetName": "utf8","DBStatus": "Creating","DBDescription": "","DBInstanceId": "rds3meynazqbzju","Accounts": {" AccountPrivilegeInfo": []},"DBName": "testdb"},{"Engine": "MySQL","CharacterSetName": "gbk","DBStatus": "Creating","DBDescription": "","DBInstanceId": "rds3meynazqbzju","Accounts": {" AccountPrivilegeInfo": []},"DBName": "testdb2"}]}}