DescribeDrdsDbInstances

The list of ApsaraDB RDS for MySQL primary instances used by the database is returned. The ReadOnlyInstances parameter of each returned ApsaraDB RDS for MySQL primary instance indicates the read-only instances that are used by the primary instance to store the data of the specified database.

Request parameters

Response parameters

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeDrdsDbInstances
&DrdsInstanceId=drdshbga1138****
&DbName=dbname
&PageNumber=1
&PageSize=30
&<Common request parameters>

Sample success responses

XML format

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

<DescribeDrdsDbInstancesResponse>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <RequestId>2F7F8080-9132-4279-85D0-B7E5C4305162</RequestId>
    <Total>1</Total>
    <Success>true</Success>
    <DbInstances>
        <ExpireTime>1237486127634</ExpireTime>
        <PayType>PostPaid</PayType>
        <DBInstanceStatus>1</DBInstanceStatus>
        <NetworkType>VPC</NetworkType>
        <Port>3306</Port>
        <EngineVersion>5.7</EngineVersion>
        <DmInstanceId>dm-hbgau1zp****</DmInstanceId>
        <ConnectUrl>rm-bp1t1mk5a5b******.mysql.rds.aliyuncs.com</ConnectUrl>
        <ReadWeight>30</ReadWeight>
        <RdsInstType>Primary</RdsInstType>
        <RemainDays>0</RemainDays>
        <DBInstanceId>rm-bp1t1mk5a5bdj****</DBInstanceId>
        <DbInstType>RDS</DbInstType>
        <Engine>MySQL</Engine>
        <ReadOnlyInstances>
            <ExpireTime>123421352351234</ExpireTime>
            <PayType>Postpaid</PayType>
            <DBInstanceStatus>1</DBInstanceStatus>
            <NetworkType>VPC</NetworkType>
            <Port>3306</Port>
            <EngineVersion>5.7</EngineVersion>
            <DmInstanceId>dm-hbgau1zp****</DmInstanceId>
            <ConnectUrl>rm-bp1t1mk5a5b******.mysql.rds.aliyuncs.com</ConnectUrl>
            <ReadWeight>70</ReadWeight>
            <RdsInstType>RDS</RdsInstType>
            <InstanceName>**</InstanceName>
            <RemainDays>0</RemainDays>
            <DbInstType>RDS</DbInstType>
            <Engine>MySQL</Engine>
        </ReadOnlyInstances>
    </DbInstances>
</DescribeDrdsDbInstancesResponse>

JSON format

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

{
  "PageSize" : "10",
  "PageNumber" : "1",
  "RequestId" : "2F7F8080-9132-4279-85D0-B7E5C4305162",
  "Total" : "1",
  "Success" : true,
  "DbInstances" : [ {
    "ExpireTime" : "1237486127634",
    "PayType" : "PostPaid",
    "DBInstanceStatus" : "1",
    "NetworkType" : "VPC",
    "Port" : 3306,
    "EngineVersion" : "5.7",
    "DmInstanceId" : "dm-hbgau1zp****",
    "ConnectUrl" : "rm-bp1t1mk5a5b******.mysql.rds.aliyuncs.com",
    "ReadWeight" : 30,
    "RdsInstType" : "Primary",
    "RemainDays" : 0,
    "DBInstanceId" : "rm-bp1t1mk5a5bdj****",
    "DbInstType" : "RDS",
    "Engine" : "MySQL",
    "ReadOnlyInstances" : [ {
      "ExpireTime" : "123421352351234",
      "PayType" : "Postpaid",
      "DBInstanceStatus" : "1",
      "NetworkType" : "VPC",
      "Port" : 3306,
      "EngineVersion" : "5.7",
      "DmInstanceId" : "dm-hbgau1zp****",
      "ConnectUrl" : "rm-bp1t1mk5a5b******.mysql.rds.aliyuncs.com",
      "ReadWeight" : 70,
      "RdsInstType" : "RDS",
      "InstanceName" : "**",
      "RemainDays" : 0,
      "DbInstType" : "RDS",
      "Engine" : "MySQL"
    } ]
  } ]
}

Error codes

For a list of error codes, visit the API Error Center.