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

DescribeDatabases

最近更新时间：2023.11.03 15:34:29

首次发布时间：2022.04.12 19:05:15

我的收藏

调用 DescribeDatabases 接口查询指定实例的数据库列表。

请求类型

同步请求。

请求参数

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

InstanceId

String

是

vedbm-r3xq0zdl****

实例 ID。

说明

您可以调用 DescribeDBInstances 接口查询实例 ID。

PageNumberInteger否1页码，取值大于等于 1，且不超过 Integer 的最大值，默认值为 1。
PageSizeInteger否10每页记录数。取值范围 1~1000，默认值为 10。

DBName

String

否

testdb1

数据库名称。

说明

在进行模糊搜索时，下划线（_）不作为通配符使用，而是直接匹配下划线（_）本身。

返回参数

名称类型示例值描述
TotalInteger2数据库总数。
DatabasesArray of DatabaseObject请参见返回示例。数据库列表。详细信息，请参见 DatabaseObject。

请求示例

POST /?Action=DescribeDatabases&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host：vedbm.volcengineapi.com
X-Date: 20220101T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20220101/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****

{
        "InstanceId": "vedbm-ca12cbqv****",
        "PageNumber" : 1,
        "PageSize" : 10
}

返回示例

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "202204121256390101940591000F55D8A9",
        "Action": "DescribeDatabases",
        "Version": "2022-01-01",
        "Service": "vedbm",
        "Region": "cn-beijing"
    },
   "Result": {
        "Databases": [
            {
                "CharacterSetName": "utf8mb4",
                "DBName": "db1",
                "DatabasesPrivileges": [
                    {
                        "AccountName": "u1",
                        "AccountPrivilege": "ReadWrite"
                    }
                ]
            },
            {
                "CharacterSetName": "utf8",
                "DBName": "testdb1",
                "DatabasesPrivileges": [
                    {
                        "AccountName": "u1",
                        "AccountPrivilege": "ReadWrite"
                    }
                ]
            }
        ],
        "Total": 2
    }
}

错误码

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