Ativar ou desativar o recurso de proxy de banco de dados - : Central de Documentação do Alibaba Cloud

O recurso de proxy dedicado do ApsaraDB RDS for MySQL oferece funcionalidades como divisão de leitura e gravação e otimização de conexões de curta duração. Para obter mais informações, consulte O que são proxies de banco de dados?
O recurso de proxy de banco de dados do ApsaraDB RDS for PostgreSQL oferece suporte à divisão de leitura e gravação. Para obter mais informações, consulte O que são proxies de banco de dados?

Antes de chamar esta operação, certifique-se de que a instância atenda aos seguintes requisitos:

Caso a instância execute o MySQL, ela deve usar uma das seguintes versões do MySQL e edições do RDS:

MySQL 8.0 com versão secundária do motor 20191204 ou posterior no RDS Enterprise Edition
MySQL 8.0 com versão secundária do motor 20190915 ou posterior no RDS High-availability Edition
MySQL 5.7 com versão secundária do motor 20191128 ou posterior no RDS Enterprise Edition
MySQL 5.7 com versão secundária do motor 20190925 ou posterior no RDS High-availability Edition
MySQL 5.6 com versão secundária do motor 20200229 ou posterior no RDS High-availability Edition

Caso a instância execute o PostgreSQL, verifique se ela atende aos seguintes requisitos:

A instância executa o PostgreSQL 10, 11, 12, 13, 14 ou 15.
A instância usa SSDs padrão ou SSDs aprimorados (ESSDs).
A instância usa o RDS High-availability Edition.
A instância é uma instância primária.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar, recomendamos chamar esta operação no OpenAPI Explorer. Ele também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyDBProxy	A operação que você deseja execute. Defina o valor como ModifyDBProxy.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxx	O ID da instância. Para consultar o ID da instância, chame a operação DescribeDBInstances.
ConfigDBProxyService	String	Sim	Startup	Define se você deseja ativar ou desativar o recurso de proxy de banco de dados. Valores válidos: Startup: ative o recurso de proxy de banco de dados. Shutdown: desative o recurso de proxy de banco de dados.
DBProxyInstanceNum	String	Não	1	O número de instâncias de proxy ativadas. Valores válidos: 1 a 60. Valor padrão: 1. Nota A capacidade do proxy de banco de dados de processar solicitações aumenta de acordo com 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.
RegionId	String	Não	cn-hangzhou	O ID da região da instância. Para consultar a lista de regiões mais recente, chame a operação DescribeRegions.
InstanceNetworkType	String	Não	VPC	O tipo de rede da instância. Defina o valor como VPC. Nota Este parâmetro é obrigatório quando você ative o recurso de proxy de banco de dados para instâncias RDS que execute MySQL com SSDs padrão ou ESSDs, e para instâncias RDS que execute PostgreSQL.
VPCId	String	Não	vpc-xxxxxxxxxxxx	O ID da VPC à qual a instância pertence. Para consultar o ID da VPC da instância, chame a operação DescribeDBInstanceAttribute. Nota Este parâmetro é obrigatório quando você ative o recurso de proxy de banco de dados para instâncias RDS que execute MySQL com SSDs padrão ou ESSDs, e para instâncias RDS que execute PostgreSQL.
VSwitchId	String	Não	vsw-xxxxxxxxxxxx	O ID do vSwitch da instância. Para consultar o ID do vSwitch da instância, chame a operação DescribeDBInstanceAttribute. Nota Este parâmetro é obrigatório quando você ative o recurso de proxy de banco de dados para instâncias RDS que execute MySQL com SSDs padrão ou ESSDs, e para instâncias RDS que execute PostgreSQL.
DBProxyEngineType	String	Não	normal	Parâmetro interno. Não o especifique.
ResourceGroupId	String	Não	rg-acfmy*****	O ID do grupo de recursos.

Parâmetros da resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	FC452BB1-EED8-4278-95C7-0324B3710DF1	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyDBProxy
&DBInstanceId=rm-uf6wjk5xxxxxxx
&ConfigDBProxyService=Startup
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyDBProxyResponse>
  <RequestId>FC452BB1-EED8-4278-95C7-0324B3710DF1</RequestId>
</ModifyDBProxyResponse>

Formato JSON

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

{
  "RequestId" : "FC452BB1-EED8-4278-95C7-0324B3710DF1"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MaxscaleAlreadyExist	The Maxscale is already existed.	Mensagem de erro retornada porque o MaxScale já existe.
400	MaxscaleNotSupport	Maxscale not supported	Mensagem de erro retornada porque a instância não oferece suporte ao recurso de proxy dedicado. Verifique e especifique a configuração do proxy dedicado.
400	NetWork.NotFound	NetWork.NotFound	Mensagem de erro retornada porque a rede está indisponível.
400	InvalidVpcParameter	Either VPC ID or vSwitch ID is incorrect. Please check again.	Mensagem de erro retornada porque o ID da VPC que você especifique é inválido.
400	MaxscaleInternalError	Database proxy status is CLASS_CHANGING.	Mensagem de erro retornada porque as especificações do proxy de banco de dados estão sendo alteradas. Tente novamente mais tarde.
400	InvalidDBInstanceName	Specified parameter DBInstanceName is not valid.	Mensagem de erro retornada porque o valor do parâmetro DBInstanceName é inválido. Verifique se o valor é nulo ou uma string vazia.
404	Maxscale.NotFound	The relative maxscale instance is not found.	Mensagem de erro retornada porque a instância associada do MaxScale não foi encontrada.
404	InvalidVSwitchId.NotFound	The specified VSwitch is invalid.	Mensagem de erro retornada porque o ID do vSwitch que você especifique é inválido.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.