調用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叢集版執行個體；
  • 至少傳入MaxDelayTime或DistributionType中的一個。
DistributionType String 否 Standard

讀權重分配模式，取值：

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

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

说明
  • 當DistributionType為Custom時，必須傳入該參數；
  • 當DisrtibutionType為Standard時，傳入該參數無效。
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"
}

錯誤碼

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