调用DescribeDrdsDBs接口查看实例下的数据库详情。

调试

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

请求参数

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

系统规定参数。取值：DescribeDrdsDBs。

DrdsInstanceId String 是 drdshbga1138****

实例ID。
PageNumber Integer 否 1

页码，取值为大于0且不超过Integer数据类型的最大值，默认值为1。

PageSize Integer 否 30

每页记录数，取值为30、50或100。

默认值为30。

RegionId String 是 cn-hangzhou

地域ID。

返回数据

名称 类型 示例值 描述
PageSize String 30

每页记录数。
PageNumber String 1

页码。
RequestId String 006B7D19-8CDB-4AA6-AAE7-23C107GS3W2T

请求ID。
Total String 1

数据库列表的总数量。
Success Boolean true

请求是否成功。
Data Array of Db

数据库列表。
Db
Status String NORMAL

数据库状态。
DbName String drds_test

数据库名称。
Schema String drds_test_1563773871118kxqd

系统为拆分后的数据库分配的schema ID。
CreateTime String 1563773824000

数据库创建时间，格式为Unix时间戳，单位为毫秒。
Mode String HORIZONTAL

数据库拆分模式，取值范围如下：

  • HORIZONTAL：水平拆分
  • VERTICAL：垂直拆分
DbInstType String RDS

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

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDrdsDBs
&DrdsInstanceId=drdshbga1138****
&PageNumber=1
&PageSize=30
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDrdsDBsResponse>
    <PageSize>30</PageSize>
    <PageNumber>1</PageNumber>
    <RequestId>006B7D19-8CDB-4AA6-AAE7-23C107GS3W2T</RequestId>
    <Total>1</Total>
    <Success>true</Success>
    <Data>
        <Status>NORMAL</Status>
        <DbName>drds_test</DbName>
        <Schema>drds_test_1563773871118kxqd</Schema>
        <CreateTime>1563773824000</CreateTime>
        <Mode>HORIZONTAL</Mode>
        <DbInstType>RDS</DbInstType>
    </Data>
</DescribeDrdsDBsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : "30",
  "PageNumber" : "1",
  "RequestId" : "006B7D19-8CDB-4AA6-AAE7-23C107GS3W2T",
  "Total" : "1",
  "Success" : true,
  "Data" : [ {
    "Status" : "NORMAL",
    "DbName" : "drds_test",
    "Schema" : "drds_test_1563773871118kxqd",
    "CreateTime" : "1563773824000",
    "Mode" : "HORIZONTAL",
    "DbInstType" : "RDS"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 ActionUnauthorized The specified action is not available for you 指定的action未授权，请您先做RAM授权再进行操作。
500 InternalError The request processing has failed due to some unknown error. 请求失败，内部错误

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