You need to enable JavaScript to run this app.
导航
DescribeDatabases
最近更新时间:2024.06.13 14:27:24首次发布时间:2022.04.12 19:05:15

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

请求类型

同步请求。

请求参数

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

InstanceId

String

vedbm-r3xq0zdl****

实例 ID。

说明

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

PageNumberInteger1页码,取值大于等于 1,且不超过 Integer 的最大值,默认值为 1。
PageSizeInteger10每页记录数。取值范围 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
    }
}

错误码

更多详情,请参见错误码