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

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

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

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

调试

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

请求参数

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

系统规定参数，取值：CalculateDBInstanceWeight。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

主实例ID。

返回数据

名称 类型 示例值 描述
Items Array of DBInstanceWeight

系统指定权重列表。
DBInstanceWeight
DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。
DBInstanceType String Master

实例类型，取值：

  • Master：主实例
  • Readonly：只读实例
Weight String 100

系统实时计算的实例权重。
ReadonlyInstanceSQLDelayedTime String 30

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

RequestId String C816A4BF-A6EC-4722-95F9-2055859CCFD2

请求ID。

示例

请求示例

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

正常返回示例

XML 格式 

<CalculateDBInstanceWeightResponse>
	  <items>
		    <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
		    <DBInstanceType>Master</DBInstanceType>
		    <Weight></Weight>
		    <Availability></Availability>
	  </items>
	  <requestId>C816A4BF-A6EC-4722-95F9-2055859CCFD2</requestId>
</CalculateDBInstanceWeightResponse>

JSON 格式 

{
    "items": [
        {
            "DBInstanceId": "rm-uf6wjk5xxxxxxx",
            "DBInstanceType": "Master",
            "Weight": "",
            "Availability": ""
        }
    ],
    "requestId": "C816A4BF-A6EC-4722-95F9-2055859CCFD2"
}

错误码

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