調用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

實例類型,取值:

  • Master:主實例
  • Readonly:只讀實例
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"
    } ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。