查询 DRDS 数据库下面的 RDS 列表

查询 DRDS 数据库下面的 RDS 主实例列表,每个 RDS 主实例的 ReadOnlyInstances 属性是该 RDS 在当前数据库中使用的 RDS 只读实例列表

调试

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

请求参数

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

DRDS 数据库名称

DrdsInstanceId String drdsInstanceId

DRDS 实例 ID

AccessKeyId String ASU678UDIN9HdlahDHH

Access Key

PageNumber Integer 1

页码

PageSize Integer 30

每页数量

返回数据

名称 类型 示例值 描述
DbInstances

DRDS 数据库下的存储实例列表

DbInstance

DRDS 数据库下的存储实例列表

ConnectUrl String rm-m5xxxxxxxxx82.mysql.rds.aliyuncs.com

存储实例的链接地址,调用对应存储(比如 RDS)接口返回的链接地址

DBInstanceId String rm-m5xxxxxxxxx82

存储实例 ID

DBInstanceStatus String 1

0:创建中

1:运行中

3:删除中

5:重启中

6:升降级中

7:备份中

8:内外网切换中

9:迁移中

11:迁移数据中

12:生成灾备实例中

13:数据导入中

14:从其他 RDS 实例导入数据中

15:容灾切换中

16:创建临时实例中

17:网络创建中

18:实例克隆中

19:链路切换中

20:只读实例迁移中

DbInstType String RDS

存储实例类型,暂时只有 RDS

Engine String MySQL

存储引擎,比如 RDS 的 MySQL

EngineVersion String 5.7

存储引擎版本,比如 RDS for MySQL 的 5.7,5.6,5.5

ExpireTime String 1237486127634

存储实例过期时间

NetworkType String VPC

网络类型

PayType String PostPaid

付费类型

Port Integer 3306

端口

RdsInstType String Primary

标识是 RDS 主实例还是只读实例

ReadOnlyInstances

存储实例的只读实例列表

ReadOnlyInstance

存储实例的只读实例列表

ConnectUrl String rm-m5xxxxxxxxx82.mysql.rds.aliyuncs.com

存储实例的链接地址,调用对应存储(比如 RDS)接口返回的链接地址

DBInstanceStatus String 1

存储实例状态

DbInstType String RDS

存储实例类型

Engine String MySQL

存储实例引擎

EngineVersion String 5.7

存储实例引擎版本

ExpireTime String 123421352351234

存储实例过期时间戳

InstanceName String rm-m5xxxxxxxxx82

无用字段

NetworkType String VPC

实例网络类型

PayType String Postpaid

付费类型

Port Integer 3306

实例访问端口

RdsInstType String RDS

实例类型

ReadWeight Integer 70

实例读比例

RemainDays Integer 0

实例过期剩余天数

ReadWeight Integer 30

在该 DRDS 数据库中权重

RemainDays Integer 0

预付费实例剩余过期天数

PageNumber String 1

页码

PageSize String 10

该页大小

RequestId String 2F7F8080-9132-4279-85D0-B7E5C4305162

请求 ID

Success Boolean true

是否成功

Total String 1

RDS 主实例总数

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDrdsDbInstances&DbName=dbname&DrdsInstanceId=drdsInstanceId&<公共请求参数>

正常返回示例

XML 格式

<DescribeDrdsDbInstances>      <PageSize>10</PageSize>      <RequestId>658B6F25-442A-4996-8AAE-F77DAFBC9BAA</RequestId>      <PageNumber>1</PageNumber>      <Total>1</Total>      <DbInstances>            <DbInstance>                  <DbInstType>RDS</DbInstType>                  <ReadOnlyInstances></ReadOnlyInstances>                  <EngineVersion>5.7</EngineVersion>                  <DBInstanceStatus>1</DBInstanceStatus>                  <Port>3306</Port>                  <PayType>Postpaid</PayType>                  <ReadWeight>100</ReadWeight>                  <ConnectUrl>rm-m5xxxxxxxxx82.mysql.rds.aliyuncs.com</ConnectUrl>                  <DBInstanceId>rm-m5xxxxxxxxx82</DBInstanceId>                  <NetworkType>VPC</NetworkType>                  <RdsInstType>Primary</RdsInstType>                  <ExpireTime></ExpireTime>                  <RemainDays>0</RemainDays>                  <Engine>MySQL</Engine>            </DbInstance>      </DbInstances>      <Success>true</Success></DescribeDrdsDbInstances>

JSON 格式

{    “PageNumber”:1,    “PageSize”:10,    “RequestId”:”658B6F25-442A-4996-8AAE-F77DAFBC9BAA”,    “DbInstances”:{        “DbInstance”:[            {                “RemainDays”:0,                “ReadOnlyInstances”:{                    “ReadOnlyInstance”:[]                },                “DBInstanceId”:”rm-m5xxxxxxxxx82”,                “ReadWeight”:100,                “RdsInstType”:”Primary”,                “DbInstType”:”RDS”,                “ConnectUrl”:”rm-m5xxxxxxxxx82.mysql.rds.aliyuncs.com”,                “Engine”:”MySQL”,                “NetworkType”:”VPC”,                “Port”:3306,                “ExpireTime”:””,                “EngineVersion”:”5.7”,                “DBInstanceStatus”:1,                “PayType”:”Postpaid”            }        ]    },    “Success”:true,    “Total”:1}

错误码

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

     </article>
  </main>