调用DescribeDatabases接口查询RDS实例下的数据库信息。
说明 如果请求参数错误,返回数据为空。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDatabases |
系统规定参数,取值:DescribeDatabases。 |
DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
实例ID。 |
DBName | String | 否 | testDB01 |
数据库名称。 |
DBStatus | String | 否 | Creating |
数据库状态,取值:
|
PageSize | Integer | 否 | 30 |
每页记录数,取值:
默认值:30。 |
PageNumber | Integer | 否 | 1 |
页码,取值:大于0且不超过Integer的最大值。 默认值:1。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Databases | Array of Database |
数据库信息列表。 |
|
Database | |||
DBName | String | testDB01 |
数据库名称。 |
DBInstanceId | String | rm-uf6wjk5xxxxxxx |
数据库所属实例ID。 |
Engine | String | MySQL |
数据库实例类型。 |
DBStatus | String | Creating |
数据库状态,取值:
|
CharacterSetName | String | utf8 |
字符集。 |
DBDescription | String | 测试数据库 |
数据库描述。 |
Accounts | Array of AccountPrivilegeInfo |
拥有数据库相关权限的账号信息。 |
|
AccountPrivilegeInfo | |||
Account | String | test |
账号名称。 |
AccountPrivilege | String | DMLOnly |
账号对该数据库拥有的权限。取值:
|
AccountPrivilegeDetail | String | SELECT |
账号对该数据库具有的权限。 |
RequestId | String | 2603CA96-B17D-4903-BC04-61A2C829CD94 |
请求ID。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DescribeDatabases
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公共请求参数>
正常返回示例
XML
格式
<DescribeDatabasesResponse>
<RequestId>2603CA96-B17D-4903-BC04-61A2C829CD94</RequestId>
<Databases>
<Database>
<Engine>MySQL</Engine>
<CharacterSetName>utf8</CharacterSetName>
<DBStatus>Creating</DBStatus>
<DBDescription></DBDescription>
<DBInstanceId>rdsaiiabnaiiabn</DBInstanceId>
<Accounts></Accounts>
<DBName>testdb</DBName>
</Database>
<Database>
<Engine>MySQL</Engine>
<CharacterSetName>gbk</CharacterSetName>
<DBStatus>Creating</DBStatus>
<DBDescription></DBDescription>
<DBInstanceId>rdsaiiabnaiiabn</DBInstanceId>
<Accounts></Accounts>
<DBName>testdb2</DBName>
</Database>
</Databases></DescribeDatabasesResponse>
JSON
格式
{
"RequestId": "2603CA96-B17D-4903-BC04-61A2C829CD94",
"Databases": {
"Database": [
{
"Engine": "MySQL",
"CharacterSetName": "utf8",
"DBStatus": "Creating",
"DBDescription": "",
"DBInstanceId": "rdsaiiabnaiiabn",
"Accounts": {
" AccountPrivilegeInfo": []
},
"DBName": "testdb"
},
{
"Engine": "MySQL",
"CharacterSetName": "gbk",
"DBStatus": "Creating",
"DBDescription": "",
"DBInstanceId": "rdsaiiabnaiiabn",
"Accounts": {
" AccountPrivilegeInfo": []
},
"DBName": "testdb2"
}
]
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交