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

返回数据

名称 类型 示例值 描述
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。

Role String

废弃参数。

示例

请求示例

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

正常返回示例

XML格式

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

<CalculateDBInstanceWeightResponse>
    <RequestId>C816A4BF-A6EC-4722-95F9-2055859CCFD2</RequestId>
    <Items>
        <ReadonlyInstanceSQLDelayedTime>30</ReadonlyInstanceSQLDelayedTime>
        <Weight>100</Weight>
        <DBInstanceType>Master</DBInstanceType>
        <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
    </Items>
</CalculateDBInstanceWeightResponse>

JSON格式

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

{
  "RequestId" : "C816A4BF-A6EC-4722-95F9-2055859CCFD2",
  "Items" : [ {
    "ReadonlyInstanceSQLDelayedTime" : "30",
    "Weight" : "100",
    "DBInstanceType" : "Master",
    "DBInstanceId" : "rm-uf6wjk5xxxxxxx"
  } ]
}

错误码

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