调用CalculateDBInstanceWeight接口查询系统权重分配值。

在开启读写分离的情况下,该接口用于计算系统指定的权重。如果是自定义读权重,请参见DescribeDBInstanceNetInfo

调用该接口时,实例必须满足以下条件,否则将操作失败:

  • MySQL实例使用的是共享代理。
  • 实例为如下版本:
    • MySQL 5.7高可用版(本地SSD盘)
    • MySQL 5.6
    • SQL Server集群版

调试

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

请求参数

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

系统规定参数。取值:CalculateDBInstanceWeight

DBInstanceId String rm-uf6wjk5xxxxxxx

主实例ID。

返回数据

名称 类型 示例值 描述
RequestId String C816A4BF-A6EC-4722-95F9-2055859CCFD2

请求ID。

Items Array of DBInstanceWeight

系统指定权重列表。

DBInstanceWeight
ReadonlyInstanceSQLDelayedTime String 30

只读实例延迟复制时间,只读实例延迟ReadonlyInstanceSQLDelayedTime的时间后再同步主实例数据,单位:秒。

Weight String 100

系统实时计算的实例权重。

DBInstanceType String Master

实例类型,取值:

  • Master:主实例
  • Readonly:只读实例
DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=CalculateDBInstanceWeight
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公共请求参数>

正常返回示例

XML格式

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

<CalculateDBInstanceWeightResponse>
    <RequestId>4139E1C3-0480-5A50-B327-23E6B1028906</RequestId>
    <Items>
        <DBInstanceWeight>
            <Role>master</Role>
            <DBInstanceId>******</DBInstanceId>
            <DBInstanceType>Readonly</DBInstanceType>
            <Weight>400</Weight>
        </DBInstanceWeight>
        <DBInstanceWeight>
            <Role>master</Role>
            <DBInstanceId>******</DBInstanceId>
            <DBInstanceType>Master</DBInstanceType>
            <Weight>0</Weight>
        </DBInstanceWeight>
        <DBInstanceWeight>
            <Role>slave</Role>
            <DBInstanceId>******</DBInstanceId>
            <DBInstanceType>Master</DBInstanceType>
            <Weight>1600</Weight>
        </DBInstanceWeight>
    </Items>
</CalculateDBInstanceWeightResponse>

JSON格式

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

{
  "RequestId" : "4139E1C3-0480-5A50-B327-23E6B1028906",
  "Items" : {
    "DBInstanceWeight" : [ {
      "Role" : "master",
      "DBInstanceId" : "******",
      "DBInstanceType" : "Readonly",
      "Weight" : "400"
    }, {
      "Role" : "master",
      "DBInstanceId" : "******",
      "DBInstanceType" : "Master",
      "Weight" : "0"
    }, {
      "Role" : "slave",
      "DBInstanceId" : "******",
      "DBInstanceType" : "Master",
      "Weight" : "1600"
    } ]
  }
}

错误码

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