You need to enable JavaScript to run this app.
导航
云数据库 MySQL 版
  • 文档首页
    • /
  • 云数据库 MySQL 版

ListDatabases

最近更新时间：2023.05.23 18:46:14

首次发布时间：2021.11.29 16:48:57

我的收藏

调用 ListDatabases 接口查询 MySQL 实例的数据库信息。

请求类型

同步请求。

请求参数

名称类型是否必选示例值描述

InstanceId

String

是

mysql-603e30e6****

实例 ID 。

说明

您可以调用 ListDBInstances 接口查询实例信息，包括实例 ID 。

OffsetInteger否0当前页查询偏移量。
LimitInteger否10每页记录数，取值：大于 0 且不超过 Integer 的最大值。
DBStatusString否Running数据库状态。取值只能为 Running，即运行中。

返回参数

名称类型示例值描述
TotalInteger1数据库总数。

Datas

Array of DBInfo

[
{
"DBName": "testdb",
"DBDesc":"这是一段数据库的描述信息",
"DBStatus": "Running",
"CharacterSetName": "utf8,
"AccountNames": "testuser1,testuser2"
}
]

数据库列表。关于 Databases 的详细信息，请参见数据结构。

请求示例

POST /?Action=ListDatabases&Version=2018-01-01 HTTP/1.1
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request, SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645a****

{
    "InstanceId" : "mysql-603e30e6****",
    "Offset" : 0,
    "Limit" : 10,
    "DBStatus" : "Running",
}

正常返回示例

{
    "ResponseMetadata" : {
        "RequestId": "d78bbf4e-63a5-4937-ac3c-3767e7eddfbe",
        "Action": "ListDatabases",
        "Version": "2018-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "Total" : 1,
        "Datas" : [
            {
                "DBName" : "testdb1",
								"DBDesc":"这是一段数据库 testdb1 的描述信息",
                "DBStatus" : "Running",
                "CharacterSetName": "utf8",
                "AccountNames": "testuser1,testuser2"
            }
        ]
    }
}

错误码

更多详情，请参见错误码。