查询 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
}

错误码

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