Todos os produtos
Search
Central de documentação

:Modifique as configurações do proxy de banco de dados

Última atualização: Jun 26, 2026

Chame a operação ModifyDBProxyInstance para modificar as configurações do proxy de banco de dados de uma instância do ApsaraDB RDS.

Antes de chamar a operação ModifyDBProxyInstance, certifique-se de que a operação ModifyDBProxy foi chamada para ativar o recurso de proxy de banco de dados na instância.

  • O recurso de proxy dedicado do ApsaraDB RDS for MySQL oferece capacidades como divisão de leitura/gravação e otimização de conexões de curta duração. Para obter mais informações, consulte What are database proxies?

  • O recurso de proxy de banco de dados do ApsaraDB RDS for PostgreSQL oferece suporte à divisão de leitura/gravação. Para obter mais informações, consulte What are database proxies?

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Parâmetros de requisição

Parameter Type Required Example Description
Action String Yes ModifyDBProxyInstance

A operação a ser executada. Defina o valor como ModifyDBProxyInstance.

DBInstanceId String Yes rm-t4n3a****

O ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.

DBProxyInstanceType String Yes DedicatedProxy

O tipo de proxy de banco de dados ativado para a instância. Defina o valor como DedicatedProxy.

DBProxyInstanceNum String Yes 2

O número de instâncias de proxy ativadas. Se o valor deste parâmetro for 0, o recurso de proxy de banco de dados será desativado para a instância. Valores válidos: 1 a 60.

Nota A capacidade do proxy de banco de dados de processar requisições aumenta conforme o número de instâncias de proxy ativadas. Monitore a carga da instância e especifique um número adequado de instâncias de proxy com base nos dados de monitoramento de carga.
EffectiveTime String No MaintainTime

O momento em que as novas configurações do proxy de banco de dados serão aplicadas. Valores válidos:

  • Immediate: o ApsaraDB RDS aplica as novas configurações imediatamente.
  • MaintainTime: o ApsaraDB RDS aplica as novas configurações durante a janela de manutenção especificada. Para obter mais informações, consulte Modifique the maintenance window.
  • SpecificTime: o ApsaraDB RDS aplica as novas configurações em um momento específico.

Valor padrão: MaintainTime.

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

O momento específico em que as novas configurações do proxy de banco de dados serão aplicadas. Especifique o horário no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC.

Nota Se o parâmetro EffectiveTime for definido como SpecificTime, especifique também o parâmetro EffectiveSpecificTime.
RegionId String No cn-hangzhou

O ID da região onde a instância reside. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

DBProxyEngineType String No normal

Parâmetro interno. Não é necessário especificá-lo.

Parâmetros de resposta

Parameter

Type

Example

Description

RequestId

String

65C55572-530E-4A53-BE03-1D08CAF0F046

O ID da requisição.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=ModifyDBProxyInstance
&DBInstanceId=rm-t4n3a****
&DBProxyInstanceType=DedicatedProxy
&DBProxyInstanceNum=2
&EffectiveTime=Immediate
&<Common request parameters>

Exemplos de resposta bem-sucedida

XML format

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

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

JSON format

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

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

Códigos de erro

HTTP status code

Error code

Error message

Description

400

InvalidDBInstanceName

Specified parameter DBInstanceName is not valid.

O erro foi retornado porque o valor do parâmetro DBInstanceName é inválido. Verifique se o valor é nulo ou uma string vazia.

403

DBInstanceStatusNotActive

Current DB instance status should be active.

O erro foi retornado porque o status atual da instância não oferece suporte à operação.

403

InvalidInstanceLevel.Malformed

The specified class code does not support the endpoint number. Please check the shard number and the current endpoint number.

O erro foi retornado porque o tipo da instância não oferece suporte ao número de terminais de proxy especificado. Verifique o número de instâncias de proxy e o número de terminais de proxy.

Para obter uma lista de códigos de erro, acesse o API Error Center.