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

调试

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

请求参数

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

系统规定参数。取值为DescribeDbInstanceDbs。

DbInstanceId String 是 pc-****************

存储层数据库所属实例的ID。
DrdsInstanceId String 是 drds************

实例ID。
AccountName String 否 test

PolarDB-X高级账号名称，若没有高级账号则无需填写。关于高级账号，详情请参见账号管理。

Password String 否 pwd_111111

PolarDB-X高级账号密码，若没有高级账号则无需填写。关于高级账号，详情请参见账号管理。

DbInstType String 否 POLARDB

数据库存储类型，取值为POLARDB或RDS。

返回数据

名称 类型 示例值 描述
Databases Array of Database

数据库详情列表。
Database
DbName String db_test

数据库名称。
Description String test

数据库描述。
Status Integer 1

数据库状态，取值范围如下：

  • 0：创建中
  • 1：可用
  • 3：正在删除
RequestId String E9F3D991-08DE-4B74-BE0E-06B809******

请求ID。
Success Boolean true

请求结果。
Total String 1

数据库总数。

示例

请求示例

http(s)://drds.cn-hangzhou.aliyuncs.com/?Action=DescribeDbInstanceDbs
&DbInstanceId=pc-****************
&DrdsInstanceId=drds************
&<公共请求参数>

正常返回示例

XML 格式 

<Databases>
    <Database>
        <Status>1</Status>
        <Description>test</Description>
        <DbName>db_test</DbName>
    </Database>
</Databases>
<total>1</total>
<RequestId>E9F3D991-08DE-4B74-BE0E-06B809******</RequestId>
<Success>true</Success>

JSON 格式 

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

错误码

HttpCode 错误码 错误信息 描述
400 ActionUnauthorized The specified action is not available for you 指定的action未授权，请您先做RAM授权再进行操作。

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