DescribeDrdsDbInstances
查询 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
}
错误码
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论