Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Configure a database proxy endpoint

Última atualização: Aug 21, 2026

Após ative o proxy de banco de dados em uma instância do ApsaraDB RDS for MySQL, os clientes se conectam por meio de um endpoint de proxy. Este tópico explica os tipos de endpoint e como adicionar, modifique, alternar e liberar endpoints de proxy, incluindo endpoints públicos.

Limitações

  • Uma única instância do ApsaraDB RDS for MySQL suporta de 1 a 7 endpoints de proxy. Ao ative o proxy de banco de dados, o sistema cria um endpoint por padrão.

  • Cada endpoint de proxy suporta um endpoint interno (Virtual Private Cloud (VPC)) e um endpoint público.

  • Mantenha pelo menos um endpoint de proxy. Liberar um endpoint de proxy remove permanentemente seu ID, endpoint interno e endpoint público.

  • A alteração do vSwitch de um endpoint de proxy é suportada apenas em instâncias com disco cloud.

  • Não é mais possível criar endpoints de rede clássica desde 7 de dezembro de 2023. Os endpoints de rede clássica existentes continuam funcionando, mas não podem ser restaurados após a liberação.

Pré-requisitos

Antes de começar, verifique se você:

Tipos de endpoint

Cada endpoint de proxy suporta até dois endereços:

Formato do endereço do endpoint

O endereço de um endpoint de proxy segue a estrutura abaixo. Tomando rm-*****.rwlb.cn-chengdu.rds.aliyuncs.com:3306 como exemplo:

Segmento

Descrição

Exemplo

rm-*****

Prefixo personalizável. Deve começar com uma letra minúscula, ter entre 2 e 40 caracteres e conter apenas letras, dígitos e hifens (-).

rm-bp1abc123

rwlb

Identificador do proxy de divisão de leitura/escrita.

rwlb

cn-chengdu

Região onde a instância está implantada.

cn-hangzhou

rds.aliyuncs.com

Nome de domínio do service RDS da Alibaba Cloud.

3306

Porta padrão do MySQL. Configurável no intervalo de 1000 a 5999 para endpoints públicos.

3306

Adicionar um endpoint de proxy

  1. Acesse a página RDS Instances. Selecione uma região e clique em no ID da instância desejada.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Na parte superior da seção Connection Information, clique em Add Database Proxy Endpoint.

  4. Na caixa de diálogo, configure a política de acesso do endpoint e clique em OK. Para detalhes da configuração, consulte Configure an access policy for a database proxy endpoint.

Alternar o vSwitch de um endpoint de proxy

Importante

Esta operação é suportada apenas em instâncias com disco cloud. Alterar o vSwitch causa uma desconexão transitória de aproximadamente 30 segundos nas conexões pelo endpoint de proxy. As conexões pelos endpoints da instância primária ou somente leitura não são afetadas. Execute esta operação fora dos horários de pico ou direcione temporariamente o tráfego da aplicação para o endpoint da instância primária ou somente leitura. Certifique-se de que sua aplicação possua um mecanismo de reconexão automática.

  1. Acesse a página RDS Instances. Selecione uma região e clique em no ID da instância desejada.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Na seção Connection Information, em Network Information do endpoint de proxy alvo, clique em Switch vSwitch.

  4. Na caixa de diálogo, selecione um Target vSwitch e um Change Time, depois clique em OK.

Modifique o endereço ou porta de um endpoint de proxy

  1. Acesse a página RDS Instances. Selecione uma região e clique em no ID da instância desejada.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Na seção Connection Information, clique em no ícone image.png ao lado do endpoint de proxy desejado.

  4. Na caixa de diálogo, defina o prefixo do endereço de conexão e a Port, depois clique em OK.

Se você fez upgrade de um proxy compartilhado para um proxy dedicado, o sufixo do endpoint de proxy será alterado na primeira modificação.

Liberar um endpoint de proxy

Liberar um endpoint de proxy remove permanentemente seu ID, endpoint interno e endpoint público. Mantenha pelo menos um endpoint de proxy.
  1. Acesse a página RDS Instances. Selecione uma região e clique em no ID da instância desejada.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Clique em Delete Connection ao lado do endpoint de proxy desejado. Na caixa de diálogo, clique em OK.

Gerencie endpoints públicos

Cada endpoint de proxy suporta um endpoint público. Ao solicitar um endpoint público, o prefixo deve começar com uma letra minúscula, ter entre 2 e 40 caracteres e conter apenas letras, dígitos e hifens (-). A porta deve estar no intervalo de 1000 a 5999.

Solicitar um endpoint público

Solicite um endpoint público na página Database Proxy ou na página Database Connection.

Pela página Database Proxy:

  1. Acesse a página RDS Instances. Selecione uma região e clique em no ID da instância desejada.

  2. No painel de navegação à esquerda, clique em Database Proxy.

  3. Na seção Connection Information, localize o endpoint de proxy desejado. Na coluna Public Endpoint/Port, clique em Request Public Endpoint.

  4. Defina o prefixo do endpoint público e a Port, depois clique em OK.

  5. Pela página Database Connection:

    1. Acesse a página RDS Instances. Selecione uma região e clique em no ID da instância desejada.

    2. No painel de navegação à esquerda, clique em Database Connection.

    3. Na seção Database Proxy Endpoint, clique em Apply for Public Endpoint. Defina o prefixo e a Port, depois clique em OK.

    Liberar um endpoint público

    Libere um endpoint público na página Database Proxy ou na página Database Connection.

    Pela página Database Proxy:

    1. Acesse a página RDS Instances. Selecione uma região e clique em no ID da instância desejada.

    2. No painel de navegação à esquerda, clique em Database Proxy.

    3. Ao lado do endpoint público que deseja liberar, clique em Release Public Endpoint. Na caixa de diálogo, clique em OK.

    Pela página Database Connection:

    1. Acesse a página RDS Instances. Selecione uma região e clique em no ID da instância desejada.

    2. No painel de navegação à esquerda, clique em Database Connection.

    3. Na seção Database Proxy Connection, ao lado do endpoint público que deseja liberar, clique em Release Public Endpoint. Na caixa de diálogo, clique em OK.

    Próximos passos

    Referência de API

    API

    Descrição

    DescribeDBProxy

    Consulta detalhes do proxy de banco de dados de uma instância RDS.

    DescribeDBProxyEndpoint

    Consulta informações de endpoints de proxy de uma instância RDS.

    ModifyDBProxyEndpoint

    Modifica configurações de endpoints de proxy de uma instância RDS.

    CreateDBProxyEndpointAddress

    Cria um endereço para um endpoint de proxy de banco de dados.

    ModifyDBProxyEndpointAddress

    Modifica um endereço de um endpoint de proxy de banco de dados.

    DeleteDBProxyEndpointAddress

    Exclua um endereço de um endpoint de proxy de banco de dados.