调用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。

示例

请求示例

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

正常返回示例

XML 格式

1
2
3
4
5
6
7
8
9
<CalculateDBInstanceWeightResponse>
      <items>
            <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
            <DBInstanceType>Master</DBInstanceType>
            <Weight></Weight>
            <Availability></Availability>
      </items>
      <requestId>C816A4BF-A6EC-4722-95F9-2055859CCFD2</requestId>
</CalculateDBInstanceWeightResponse>

JSON 格式

1
2
3
4
5
6
7
8
9
10
11
{
    "items": [
        {
            "DBInstanceId": "rm-uf6wjk5xxxxxxx",
            "DBInstanceType": "Master",
            "Weight": "",
            "Availability": ""
        }
    ],
    "requestId": "C816A4BF-A6EC-4722-95F9-2055859CCFD2"
}

错误码

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