調(diào)用ModifyReadWriteSplittingConnection接口修改讀寫分離鏈路的延遲閾值和各個實例的讀權(quán)重。

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

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

調(diào)試

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

請求參數(shù)

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

主實例ID。
ConnectionStringPrefix String 否 rm-m5xxxxxxxxrw.mysql.rds.aliyuncs.com

讀寫分離地址前綴名，不可重復，由小寫字母和中劃線組成，需以字母開頭，長度不超過30個字符。

說明 默認以“實例名+rw”字符串組成前綴。
Port String 否 3306

讀寫分離地址端口號。
MaxDelayTime String 否 12

延遲閾值，單位為秒。當只讀實例延遲時間超過該閾值時，讀取流量不發(fā)往該實例。不傳該參數(shù)則保持原值。

說明
  • 參數(shù)MaxDelayTime不適用于SQL Server 2017集群版實例。
  • 至少傳入MaxDelayTime或DistributionType中的一個。
DistributionType String 否 Standard

讀權(quán)重分配模式，取值：

  • Standard：按規(guī)格權(quán)重自動分配
  • Custom：自定義分配權(quán)重
說明 至少傳入MaxDelayTime或DistributionType中的一個。
Weight String 否 {"rm-bp1**********":800,"master":400,"slave":400}

讀權(quán)重分配，即傳入主實例和只讀實例的讀請求權(quán)重。以100遞增，最大值為10000。

  • RDS實例格式：{"<只讀實例ID>":<權(quán)重>,"master":<權(quán)重>,"slave":<權(quán)重>}
  • MyBASE實例格式：[{"instanceName":"<主實例ID>","weight":<權(quán)重>,"role":"master"},{"instanceName":"<主實例ID>","weight":<權(quán)重>,"role":"slave"},{"instanceName":"<只讀實例ID>","weight":<權(quán)重>,"role":"master"}]
說明
  • 當DistributionType為Custom時，必須傳入該參數(shù)。
  • 當DisrtibutionType為Standard時，傳入該參數(shù)無效。

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

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

請求ID。

示例

請求示例

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

正常返回示例

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. 操作失敗，指定統(tǒng)一只讀網(wǎng)絡類型不存在。
400 ReadDBInstance.NotFound The Current DB Instance has not read-only instance. 操作失敗，當前數(shù)據(jù)庫實例沒有只讀實例。
403 ReadDBInstance.NotFound The current database instance does not contain any read only instance. 當前數(shù)據(jù)庫實例沒有只讀實例。

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