调用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

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

返回数据

名称 类型 示例值 描述
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授权再进行操作。

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