Todos os produtos
Search
Central de documentação

:Modifique um endpoint de proxy

Última atualização: Jun 29, 2026

Use a operação ModifyDBProxyEndpointAddress para modificar um endpoint de conexão ao proxy de banco de dados de uma instância do ApsaraDB RDS.

Ao ativar o recurso de proxy de banco de dados, o sistema gera um endpoint de proxy padrão vinculado ao recurso de terminal de proxy. Você pode criar, modifique ou exclua endpoints de proxy.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação, pois ela gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ModifyDBProxyEndpointAddress

Operação a ser executada. Defina o valor como ModifyDBProxyEndpointAddress.

DBInstanceId String Sim rm-t4n3a****

ID da instância. Para consultar esse ID, chame a operação DescribeDBInstances.

DBProxyEndpointId String Sim ta9um4****

ID do endpoint de proxy. Para obter essa informação, chame a operação DescribeDBProxyEndpoint.

DBProxyNewConnectString String Não test123456

Novo prefixo do endpoint de proxy. Insira o prefixo desejado.

Nota Especifique pelo menos um dos parâmetros: DBProxyNewConnectString ou DBProxyNewConnectStringPort.
DBProxyNewConnectStringPort String Não 3307

Número da porta associada ao endpoint de proxy. Insira o número da porta.

Nota Especifique pelo menos um dos parâmetros: DBProxyNewConnectString ou DBProxyNewConnectStringPort.
DBProxyConnectStringNetType String Não Public

Tipo de rede do endpoint de proxy. Valores válidos:

  • Public: Internet
  • VPC: Virtual Private Cloud (VPC)
  • Classic: Rede clássica

Para instâncias MySQL, o valor padrão é Classic.

Nota Em instâncias PostgreSQL, defina este parâmetro como Public ou VPC.
DBProxyEngineType String Não normal

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

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

50F6C32B-DD73-4DA1-ADA2-0EAF2B0FCD8A

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=ModifyDBProxyEndpointAddress
&DBInstanceId=rm-t4n3a****
&DBProxyEndpointId=ta9um4****
&DBProxyNewConnectString=test123456
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyDBProxyEndpointAddressResponse>
<RequestId>50F6C32B-DD73-4DA1-ADA2-0EAF2B0FCD8A</RequestId>
</ModifyDBProxyEndpointAddressResponse>

Formato JSON

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

{
  "RequestId" : "50F6C32B-DD73-4DA1-ADA2-0EAF2B0FCD8A"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

InvalidConnectionString.Format

Specified connection string is not valid.

O novo prefixo do endpoint de proxy é inválido. O prefixo deve ter de 5 a 40 caracteres.

400

InvalidPort.Malformed

Specified port is not valid.

O número da porta especificado é inválido.

400

InvalidConnectionString.Duplicate

Specified connection string already exists in the Aliyun RDS.

O ID do endpoint de proxy especificado já existe. Especifique outro ID.

400

InvalidConnectionStringOrPort.Duplicate

Specified connection string or port want to be modified is the same with current net type.

O ID do endpoint de proxy ou o número da porta especificado já existe. Informe um ID ou porta diferente.

400

InvalidDBInstanceName

Specified parameter DBInstanceName is not valid.

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

403

ParameterLeastAssociate

Must input at least one optional parameter.

Os parâmetros restoreTime e BackupId da instância estão vazios. Especifique pelo menos um deles e tente novamente.

404

InvalidConnectionString.NotFound

Specified connection string or net type is not found.

O endpoint de proxy especificado não foi encontrado. Verifique se o endpoint está correto.

404

Endpoint.NotFound

Specified endpoint is not found.

O número da porta especificado não foi encontrado.

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