调用ModifyDBProxyInstance接口修改RDS数据库独享代理设置。

RDS提供数据库独享代理服务,包括读写分离、短连接优化等能力。详情请参见数据库独享代理

调用该接口时,实例必须满足以下条件:

  • 实例已开通数据库独享代理功能。
  • 实例版本如下:
    • MySQL 8.0三节点企业版(内核小版本20191204或以上)
    • MySQL 8.0高可用版(内核小版本20190915或以上)
    • MySQL 5.7三节点企业版(内核小版本20191128或以上)
    • MySQL 5.7高可用版(内核小版本20190925或以上)

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyDBProxyInstance

系统规定参数,取值:ModifyDBProxyInstance

DBInstanceId String rm-t4n3axxxxx

实例ID。

DBProxyInstanceNum String 2

设置代理实例数量。当取值为0的时候,表示这个实例关闭此种类型代理服务。取值:0~60

说明 更多的代理实例能处理更多的请求,您可以根据监控数据了解代理实例的负载,然后设置合理的代理实例数量。
DBProxyInstanceType String DedicatedProxy

代理服务类型。当前仅支持独享代理服务,取值:DedicatedProxy

EffectiveTime String MaintainTime

生效时间,取值:

  • Immediate:立即生效。
  • MaintainTime:在可运维时间段内生效,请参见ModifyDBInstanceMaintainTime
  • SpecificTime:指定时间生效。

默认值:MaintainTime

EffectiveSpecificTime String 2019-07-10T13:15:12Z

指定时间生效。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 EffectiveTime = SpecificTime时必传。
RegionId String cn-hangzhou

地域ID,可以通过接口DescribeRegions查看地域ID。

返回数据

名称 类型 示例值 描述
RequestId String 65C55572-530E-4A53-BE03-1D08CAF0F046

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=ModifyDBProxyInstance
&DBInstanceId=rm-t4n3axxxxx
&DBProxyInstanceType=DedicatedProxy
&DBProxyInstanceNum=2
&EffectiveTime=Immediate
&<公共请求参数>

正常返回示例

XML 格式

<ModifyDBProxyInstanceResponse>
    <RequestId>65C55572-530E-4A53-BE03-1D08CAF0F046</RequestId>
</ModifyDBProxyInstanceResponse>

JSON 格式

{
	"RequestId": "65C55572-530E-4A53-BE03-1D08CAF0F046"
}

错误码

访问错误中心查看更多错误码。