调用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 |
实例类型,取值:
|
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"
} ]
}
}
错误码
访问错误中心查看更多错误码。