修改讀權重和延遲閾值 -

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

MySQL執行個體使用的是共用代理。
MySQL執行個體已開通讀寫分離。
執行個體為如下版本：
- MySQL 5.7高可用版（本地SSD盤）
- MySQL 5.6
- SQL Server叢集版

調試

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

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	ModifyReadWriteSplittingConnection	系統規定參數。取值：ModifyReadWriteSplittingConnection。
DBInstanceId	String	是	rm-uf6wjk5xxxxxxx	主執行個體ID。
ConnectionStringPrefix	String	否	rm-m5xxxxxxxxrw.mysql.rds.aliyuncs.com	讀寫分離地址首碼名，不可重複，由小寫字母和中劃線組成，需以字母開頭，長度不超過30個字元。說明預設以“執行個體名+rw”字串組成首碼。
Port	String	否	3306	讀寫分離地址連接埠號碼。
MaxDelayTime	String	否	12	延遲閾值，單位為秒。當唯讀執行個體延遲時間超過該閾值時，讀取流量不發往該執行個體。不傳該參數則保持原值。說明參數MaxDelayTime不適用於SQL Server 2017叢集版執行個體。至少傳入MaxDelayTime或DistributionType中的一個。
DistributionType	String	否	Standard	讀權重分配模式，取值： Standard：按規格權重自動分配 Custom：自訂分配權重說明至少傳入MaxDelayTime或DistributionType中的一個。
Weight	String	否	{"rm-bp1**********":800,"master":400,"slave":400}	讀權重分配，即傳入主執行個體和唯讀執行個體的讀請求權重。以100遞增，最大值為10000。 RDS執行個體格式：`{"<唯讀執行個體ID>":<權重>,"master":<權重>,"slave":<權重>}` MyBASE執行個體格式：`[{"instanceName":"<主執行個體ID>","weight":<權重>,"role":"master"},{"instanceName":"<主執行個體ID>","weight":<權重>,"role":"slave"},{"instanceName":"<唯讀執行個體ID>","weight":<權重>,"role":"master"}]` 說明當DistributionType為Custom時，必須傳入該參數。當DisrtibutionType為Standard時，傳入該參數無效。

返回資料

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

樣本

請求樣本

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

正常返回樣本

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<ModifyReadWriteSplittingConnectionResponse>
	<RequestID>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestID>
</ModifyReadWriteSplittingConnectionResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

錯誤碼

HttpCode	錯誤碼	錯誤資訊	描述
400	ReadUniformNetTypeNotExists	The specified uniform read only network type does not exist.	操作失敗，指定統一隻讀網路類型不存在。
400	ReadDBInstance.NotFound	The Current DB Instance has not read-only instance.	操作失敗，當前資料庫執行個體沒有隻讀執行個體。
403	ReadDBInstance.NotFound	The current database instance does not contain any read only instance.	當前資料庫執行個體沒有隻讀執行個體。

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