調用ModifyReadWriteSplittingConnection介面修改讀寫分離鏈路的延遲閾值和各個執行個體的讀權重。

調用該介面時,執行個體必須滿足以下條件,否則將操作失敗:

  • 執行個體狀態為運行中;
  • 執行個體中沒有正在執行的遷移任務;
  • 執行個體為如下版本:
    • MySQL 5.7高可用版(本地SSD盤)
    • MySQL 5.6
    • SQL Server 2017叢集版

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String ModifyReadWriteSplittingConnection

系統規定參數,取值:ModifyReadWriteSplittingConnection

DBInstanceId String rm-uf6wjk5xxxxxxx

主執行個體ID。

ConnectionStringPrefix String rm-m5xxxxxxxx.mysql.rds.aliyuncs.com

讀寫分離地址首碼名,不可重複,由小寫字母和中劃線組成,需以字母開頭,長度不超過30個字元。

说明 預設以“執行個體名+rw”字串組成首碼。
MaxDelayTime String 12

延遲閾值,單位為秒。當唯讀執行個體延遲時間超過該閾值時,讀取流量不發往該執行個體。不傳該參數則保持原值。

说明
  • 參數MaxDelayTime不適用於SQL Server 2017叢集版執行個體;
  • 至少傳入MaxDelayTimeDistributionType中的一個。
DistributionType String Standard

讀權重分配模式,取值:

  • Standard:按規格權重自動分配;
  • Custom:自訂分配權重。
说明 至少傳入 MaxDelayTimeDistributionType中的一個。
Weight String {“Instanceid1“:”100”,”Instanceid2”:”200”}

讀權重分配,即傳入主執行個體和唯讀執行個體的讀請求權重。以100遞增,最大值為10000,格式:{“Instanceid1“:”Weight”,”Instanceid2”:”Weight”...}。

说明
  • DistributionTypeCustom時,必須傳入該參數;
  • DisrtibutionTypeStandard時,傳入該參數無效。
AccessKeyId String LTAIfCxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。

Port String 3306

讀寫分離地址連接埠號碼。

返回資料

名稱 類型 樣本值 描述
RequestId String 5A77D650-27A1-4E08-AD9E-59008EDB6927

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=ModifyReadWriteSplittingConnection
&DistributionType=Standard
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公用請求參數>

正常返回樣本

XML 格式

<ModifyReadWriteSplittingConnectionResponse>
	  <RequestID>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestID></ModifyReadWriteSplittingConnectionResponse>

JSON 格式

{
	"RequestID":"5A77D650-27A1-4E08-AD9E-59008EDB6927"
}

錯誤碼

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