开发者社区 问答 正文

API参考 - API参考 -  数据库代理 -ModifyReadWriteSplittingConnection



描述


可修改读写分离链路的最大延迟时间和各个实例的读权重。
实例状态必须满足如下所有条件,否则将会操作失败:


  • 实例状态为运行中。

  • 实例没有迁移任务。

  • 实例没有被锁定。


请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数,取值为ModifyReadWriteSplittingConnection。DBInstanceIdString是现有主实例名。MaxDelayTimeInt否
  • 延迟阈值,单位为秒。
  • 当只读实例延迟时间超过该阈值时,读取流量不发往该实例。
  • 不传本参数则保持原值。
DistributionTypeString否读权重分配模式:
  • Standard:指按规格自动分配权重
  • Custom:指自定义分配权重
  • 至少传入MaxDelayTime或DistributionType中的一个。
WeightJson/ String否
  • 读流量权重分配,即传入主实例和只读实例的读请求权重。
  • 以100递增,最大值为10000。

  • 按如下格式传入:
    {“Instanceid“:”Weight”,”Instanceid”:”Weight”}
  • 当DistributionType为Custom时,必须传入该参数。
  • 当DisrtibutionType为Standard时,传入该参数无效。


返回参数

[tr=rgb(51, 205, 229)][td]参数 类型说明<公共返回参数>-详见公共参数

展开
收起
梨好橙 2018-09-11 23:46:15 1206 分享 版权
阿里云 AI 助理回答

要修改阿里云RDS读写分离链路的最大延迟时间和各个实例的读权重,您需要调用ModifyReadWriteSplittingConnection接口。以下是操作的具体要求和参数说明:

操作前提

  • 实例状态:确保实例处于运行中状态。
  • 迁移任务:实例上没有正在进行的迁移任务
  • 实例锁定:实例未被锁定

请求参数

  1. Action: ModifyReadWriteSplittingConnection(系统规定参数,固定值)。
  2. DBInstanceId: 必填, 字符串类型,表示现有主实例ID。您可以通过DescribeDBInstances API获取。
  3. MaxDelayTime: 可选, 整型,单位为秒,用于设置延迟阈值。当只读实例的延迟时间超过此阈值时,读取流量将不再发往该实例。如果不传此参数,则保持原有配置不变。注意,此参数不适用于SQL Server 2017集群版实例。
  4. DistributionType: 可选, 字符串类型,指定读权重分配模式。可选值为:
    • Standard: 按规格自动分配权重。
    • Custom: 自定义分配权重。 至少需要传入MaxDelayTimeDistributionType中的一个。
  5. Weight: 可选, JSON格式或字符串类型,用于自定义读流量权重分配。格式应为{"<只读实例ID>":<权重>,"master":<权重>,"slave":<权重>}。权重以100递增,最大为10000。当DistributionType设为Custom时,此参数为必填;若设为Standard,则传入无效。

返回参数

  • RequestId: 字符串类型,返回的请求ID,用于追踪操作记录。

请根据您的具体需求,准备相应的参数并通过API调用来完成配置修改。务必确保满足所有前提条件,并正确构造请求参数,以免操作失败。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答