全部产品
Search
文档中心

云原生数据库 PolarDB:DescribeDbInstanceDbs - 查看目标存储实例下的数据库列表

更新时间:Jul 10, 2026

调用DescribeDbInstanceDbs接口查看目标存储实例下的数据库列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
DrdsInstanceIdstring

实例 ID。

drds************
DbInstanceIdstring

存储层数据库所属实例的 ID。

pc-****************
AccountNamestring

DRDS 高级账号名称,若无高级账号则无需填写。

test
Passwordstring

DRDS 高级账号密码,若没有高级账号则无需填写。

pwd_111111
DbInstTypestring

数据库存储类型,取值为 POLARDBRDS

POLARDB

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

E9F3D991-08DE-4B74-BE0E-06B809******
Successboolean

请求结果。

true
Totalstring

数据库总数。

1
Databasesarray<object>

数据库详情列表。

Databaseobject
Statusinteger

数据库状态,取值范围如下:

  • 0:创建中
  • 1:可用
  • 3:正在删除
1
DbNamestring

数据库名称。

db_test
Descriptionstring

数据库描述。

test

示例

正常返回示例

JSON格式

{
  "RequestId": "E9F3D991-08DE-4B74-BE0E-06B809******",
  "Success": true,
  "Total": 1,
  "Databases": {
    "Database": [
      {
        "Status": 1,
        "DbName": "db_test",
        "Description": "test"
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400ActionUnauthorizedThe specified action is not available for you指定的action未授权,请您先做RAM授权再进行操作。
404InvalidDRDSInstanceId.NotFoundThe DrdsInstanceId provided does not exist in our records.-
500InternalErrorThe request processing has failed due to some unknown error.请求失败,内部错误

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史