調(diào)用CalculateDBInstanceWeight接口查詢系統(tǒng)權(quán)重分配值。

在開啟讀寫分離的情況下，該接口用于計算系統(tǒng)指定的權(quán)重。如果是自定義讀權(quán)重，請參見DescribeDBInstanceNetInfo。

調(diào)用該接口時，實例必須滿足以下條件，否則將操作失敗：

  • MySQL實例使用的是共享代理。
  • 實例為如下版本：
    • MySQL 5.7高可用版（本地SSD盤）
    • MySQL 5.6
    • SQL Server集群版

調(diào)試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 CalculateDBInstanceWeight

系統(tǒng)規(guī)定參數(shù)。取值：CalculateDBInstanceWeight。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

主實例ID。

返回數(shù)據(jù)

名稱 類型 示例值 描述
RequestId String C816A4BF-A6EC-4722-95F9-2055859CCFD2

請求ID。
Items Array of DBInstanceWeight

系統(tǒng)指定權(quán)重列表。
DBInstanceWeight
ReadonlyInstanceSQLDelayedTime String 30

只讀實例延遲復(fù)制時間，只讀實例延遲ReadonlyInstanceSQLDelayedTime的時間后再同步主實例數(shù)據(jù)，單位：秒。

Weight String 100

系統(tǒng)實時計算的實例權(quán)重。
DBInstanceType String Master

實例類型，取值：

  • Master：主實例
  • Readonly：只讀實例
DBInstanceId String rm-uf6wjk5xxxxxxx

實例ID。

示例

請求示例

http(s)://rds.aliyuncs.com/?Action=CalculateDBInstanceWeight
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公共請求參數(shù)>

正常返回示例

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"
    } ]
  }
}

錯誤碼

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