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

已调用ModifyDBProxy接口开通数据库代理。

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

调试

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

请求参数

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

系统规定参数。取值:ModifyDBProxyInstance

DBInstanceId String rm-t4n3a****

RDS实例ID。可调用DescribeDBInstances接口查询。

DBProxyInstanceType String DedicatedProxy

代理服务类型。固定取值:DedicatedProxy

DBProxyInstanceNum String 2

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

说明 更多的代理实例能处理更多的请求,您可以根据监控数据了解代理实例的负载,然后设置合理的代理实例数量。
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。

DBProxyEngineType String normal

内部参数,无需传入值。

返回数据

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

请求ID。

示例

请求示例

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

正常返回示例

XML格式

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

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

JSON格式

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

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

错误码

HttpCode 错误码 错误信息 描述
400 InvalidDBInstanceName Specified parameter DBInstanceName is not valid. 指定的实例名称(DBInstanceName)无效,请检查参数值是否为null或空字符串。
403 DBInstanceStatusNotActive Current DB instance status should be active. 操作失败,请检查实例运行状态。
403 InvalidInstanceLevel.Malformed The specified class code does not support the endpoint number. Please check the shard number and the current endpoint number. 操作失败,规定的规格码不支持该终端数,请检查分片数量和当前的终端数。

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