ModifyReadWriteSplittingConnection操作を呼び出して、読み書き分離リンクで許可されているレイテンシしきい値と、プライマリインスタンスとその読み取り専用インスタンスの読み取り重みを変更できます。

この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。

  • ApsaraDB RDS for MySQLインスタンスで共有プロキシ機能が有効になっています。
  • ApsaraDB RDS for MySQLインスタンスで読み書き分離機能が有効になっています。
  • インスタンスは、次のいずれかのデータベースエンジンバージョンとRDSエディションを実行する必要があります。
    • RDS High-availability EditionのMySQL 5.7 (ローカルSSDを使用)
    • MySQL 5.6
    • SQL Server on RDSクラスターエディション

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 ModifyReadWriteSplittingConnection

実行する操作です。 値をModifyReadWriteSplittingConnectionに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxx

プライマリインスタンスのID。

ConnectionStringPrefix String 任意 rm-m5xxxxxxxxrw.mysql.rds.aliyuncs.com

読み書き分離エンドポイントのプレフィックス。 プレフィックスは一意である必要があります。 長さは最大30文字で、小文字とハイフン (-) を使用できます。 小文字で始める必要があります。

説明 デフォルトのプレフィックスは、プライマリインスタンスの名前とそれに続くrwの文字で構成されます。
ポート String 任意 3306

読み書き分離エンドポイントに関連付けられているポート。

MaxDelayTime String 任意 12

読み書き分離リンクで許可されるレイテンシしきい値。 単位：秒。 読み取り専用インスタンスのレイテンシが指定されたしきい値を超えると、ApsaraDB RDSは読み取りリクエストを読み取り専用インスタンスにルーティングしなくなります。 このパラメーターを指定しない場合、このパラメーターのデフォルト値は保持されます。

説明
  • プライマリインスタンスがRDS Cluster EditionでSQL Server 2017を実行している場合、MaxDelayTimeパラメーターはサポートされません。
  • MaxDelayTimeおよびDistributionTypeパラメーターの少なくとも1つを指定する必要があります。
DistributionType String 任意 スタンダード

読み取り重みを割り当てるために使用されるメソッド。 有効な値：

  • 標準: ApsaraDB RDSは、インスタンスの仕様に基づいて、各インスタンスに読み取り重みを自動的に割り当てます。
  • カスタム: 各インスタンスに読み取り重みを手動で割り当てる必要があります。
説明 MaxDelayTimeおよび DistributionTypeパラメーターの少なくとも1つを指定する必要があります。
重量 String 任意 {"rm-bp1 **********":800,"master":400,"slave":400}

プライマリインスタンスとその読み取り専用インスタンスの読み取り重み。 読み取り重みは100の倍数である必要があり、10000を超えることはできません。

  • RDSインスタンスの形式: {"<読み取り専用インスタンスID>":<Weight>,"master":<Weight>,"slave":<Weight>}
  • ApsaraDB MyBaseインスタンスの形式: [{"instanceName":"<プライマリインスタンスID>" 、"weight":<Weight> 、"role":"master" },{"instanceName":"<プライマリインスタンスID>" 、"weight":<Weight> 、"role":"slave" },{"instanceName":"<読み取り専用IDインスタンス>" "weight":<Weight> 、"role":"master"}]
説明
  • DistributionTypeパラメーターをCustomに設定した場合、このパラメーターを指定する必要があります。
  • DistributionTypeパラメーターを標準に設定した場合、このパラメーターは無効です。

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 5A77D650-27A1-4E08-AD9E-59008EDB6927

リクエストの ID です。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=ModifyReadWriteSplittingConnection
&DistributionType=標準
&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"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 ReadUniformNetTypeNotExists 指定された統一読み取り専用ネットワークタイプは存在しません。 読み取り専用インスタンスに指定した統合ネットワークタイプが見つからない場合に返されるエラーメッセージ。
400 ReadDBInstance.NotFound 現在のDBインスタンスには読み取り専用インスタンスがありません。 読み取り専用インスタンスがインスタンスにアタッチされていない場合に返されるエラーメッセージ。
403 ReadDBInstance.NotFound 現在のデータベースインスタンスには、読み取り専用インスタンスが含まれていません。 読み取り専用インスタンスがインスタンスにアタッチされていない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。