調用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"
} ]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。