Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Visualize e gerencie endpoints e portas de instâncias

Última atualização: Sep 29, 2026

Este tópico descreve como visualizar e gerenciar endpoints e portas para as instâncias do ApsaraDB RDS for MySQL no console do RDS.

Instâncias das edições Basic Edition e High-availability Edition

As instâncias das edições Basic Edition e High-availability Edition do ApsaraDB RDS for MySQL fornecem os dois tipos de endpoints a seguir. Visualize ou modifique-os de acordo com o cenário de conexão:

Tipo de endereço

Instruções de uso

Como visualizar e modificar

Endpoint da instância

O endpoint da instância inclui um endpoint interno e um endpoint público:

  • Endpoint interno: Acesse o RDS por uma rede interna (como uma Virtual Private Cloud (VPC)) para obter baixa latência e alta estabilidade. O sistema gera esse endpoint automaticamente. Por exemplo, instâncias do ECS na mesma VPC usam o endpoint interno para acessar o banco de dados RDS.

  • Endpoint público: Acesse o RDS pela rede pública. Solicite manualmente um endpoint público (manually request a public endpoint).

Consulte as seções a seguir para visualizar e modificar os endpoints e as portas internos e públicos.

Endpoint de proxy de banco de dados

Ative o proxy de banco de dados para a instância (a Basic Edition não suporta esse recurso; a High-availability Edition o suporta) e use o endpoint de proxy de banco de dados para se conectar à instância. Isso maximiza o desempenho de divisão de leitura e gravação e reduz a carga na instância primária.

Visualize endpoints e portas internos e públicos

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região em que a instância RDS está localizada. Em seguida, encontre a instância RDS e clique no ID dela.

  2. Na página Basic Information, na seção Basic Information, clique em View Details.

    Nota

    O endpoint público aparece somente após a solicitação de um endpoint público (request a public endpoint).

    image.png

Modifique endpoints e portas internos e públicos

Nota

Se você ativou anteriormente a criptografia Secure Sockets Layer (SSL) para conexões internas ou públicas, desative o SSL primeiro (disable SSL) antes de modificar os endpoints. Desativar o SSL reinicia a instância. Execute essa operação em horários de menor movimento.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região em que a instância RDS está localizada. Em seguida, encontre a instância RDS e clique no ID dela.

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

  3. Clique em Modify Endpoint. image

  4. Na caixa de diálogo exibida, defina o prefixo do endpoint e o número da porta para o endpoint interno ou público e, em seguida, clique em OK.

    Nota

    O prefixo do endpoint deve ser globalmente exclusivo. Não o altere para um endpoint existente.

Instâncias da Cluster Edition

As instâncias da Cluster Edition do ApsaraDB RDS for MySQL fornecem um endpoint de leitura e gravação do cluster, um endpoint somente leitura do cluster, endpoints de conexão direta de nó e um endpoint de proxy de banco de dados. Visualize ou modifique-os de acordo com o cenário de conexão:

Tipo de endereço

Descrição

Como visualizar e modificar

Endpoint de leitura e gravação do cluster

Cada instância possui apenas um endpoint de leitura e gravação, conectado ao nó primário no cluster, que suporta operações de leitura e gravação. O endpoint de leitura e gravação do cluster inclui um endpoint interno (gerado automaticamente) e um endpoint público (solicite-o manualmente).

  • Endpoint interno: Acesse o RDS por uma rede interna (como uma VPC) para obter baixa latência e alta estabilidade. Por exemplo, instâncias do ECS na mesma VPC usam o endpoint interno para acessar o banco de dados RDS.

  • Endpoint público: Acesse o RDS pela rede pública.

Endpoint de leitura e gravação do cluster

Endpoint somente leitura do cluster

É possível criar apenas um endpoint somente leitura por instância. Ele se conecta aos nós secundários no cluster e suporta balanceamento de carga. O endpoint somente leitura do cluster inclui um endpoint interno (gerado automaticamente ao criar o endpoint somente leitura) e um endpoint público (solicite-o manualmente).

O endpoint somente leitura do cluster sempre mantém o número de nós secundários especificado para garantir a disponibilidade:

  • Se um nó secundário conectado ao endpoint somente leitura falhar, o sistema o reconstrói automaticamente.

  • Se um nó secundário conectado ao endpoint somente leitura for promovido a nó primário, um novo nó secundário é adicionado automaticamente ao endpoint somente leitura.

Endpoint somente leitura do cluster

Endpoint de conexão direta de nó

Conecte-se diretamente a um nó específico. O nó primário suporta operações de leitura e gravação. Os nós secundários são somente leitura.

O endpoint de conexão direta de nó inclui um endpoint interno (gerado automaticamente ao criar o endpoint de conexão direta) e um endpoint público (solicite-o manualmente).

Endpoint de conexão direta de nó

Endpoint de proxy de banco de dados

As instâncias da Cluster Edition possuem o proxy de banco de dados de uso geral ativado por padrão. Configure o endpoint de proxy como leitura e gravação ou somente leitura:

Endpoint de leitura e gravação do cluster

O endpoint de leitura e gravação do cluster inclui um endpoint interno e um endpoint público. O sistema gera o endpoint interno automaticamente após a criação da instância. Solicite um endpoint público conforme necessário.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região em que a instância RDS está localizada. Em seguida, encontre a instância RDS e clique no ID dela.

  2. Na página Basic Information, na seção Instance Topology Management > Database Connection, visualize ou modifique o endpoint de leitura e gravação do cluster e solicite um endpoint público.

    • Visualize o endpoint de leitura e gravação do cluster: Passe o mouse sobre a caixa de conexão de leitura e gravação e visualize o endpoint na janela pop-up.

    • Modifique o endpoint de leitura e gravação do cluster ou solicite um endpoint público: Clique em Edit. Na caixa de diálogo exibida, use as opções Change Endpoint, Change VPC e Apply for para solicitar um endpoint público.

    image

Endpoint somente leitura do cluster

Crie, visualize e exclua um endpoint somente leitura do cluster

Nota
  • Criar ou excluir um endpoint somente leitura do cluster não afeta o endpoint de leitura e gravação do cluster.

  • Ao excluir um endpoint somente leitura do cluster, o sistema libera tanto os endpoints internos quanto os públicos, e todas as conexões de banco de dados que usam esse endpoint são interrompidas.

  • Cada instância da Cluster Edition pode ter apenas um endpoint somente leitura do cluster. Vários nós secundários compartilham esse endpoint para balanceamento de carga.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região em que a instância RDS está localizada. Em seguida, encontre a instância RDS e clique no ID dela.

  2. Na página Basic Information, na seção Instance Topology Management > Database Connection, escolha:

    • Adicionar endereço

      Clique em Add Endpoint. Na caixa de diálogo exibida, insira ou selecione o prefixo do endpoint interno, a porta do endpoint interno, a VPC e o vSwitch. Adicione os nós secundários a serem incluídos e, em seguida, clique em OK.

    • Excluir endereço

      Na caixa de conexão somente leitura de destino, clique em Delete. Na caixa de diálogo exibida, clique em OK.

  3. Visualize o endpoint somente leitura do cluster: Na página Basic Information, na seção Instance Topology Management > Database Connection, passe o mouse sobre a caixa de conexão somente leitura e visualize o endpoint na caixa de diálogo pop-up.

    image

Ajuste a configuração de nós para o endpoint somente leitura do cluster

Nota
  • Adicione nós secundários ou ajuste os pesos dos nós: As conexões de banco de dados existentes não serão afetadas. Novas conexões (que usam o endpoint somente leitura do cluster) usam a configuração de nós atualizada para balanceamento de carga.

  • Remova nós secundários: Mantenha pelo menos um nó secundário. As conexões com o nó removido sofrerão uma desconexão transitória com duração de 30 a 120 segundos. Outros nós não serão afetados.

  • Ao ajustar os pesos dos nós secundários, certifique-se de que pelo menos um nó tenha um peso maior que 0.

  • As alterações na configuração de nós para o endpoint somente leitura do cluster aplicam-se tanto às conexões internas quanto às públicas.

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região em que a instância RDS está localizada. Em seguida, encontre a instância RDS e clique no ID dela.

  2. Na página Basic Information, na seção Instance Topology Management > Database Connection, clique em Edit na caixa de conexão somente leitura:

    image

    • Adicione nós e ajuste os pesos: Selecione os nós secundários a serem adicionados ao endpoint e clique no ícone 加入. Ajuste os pesos dos nós e, em seguida, clique em OK.

    • Remova nós: Selecione os nós a serem removidos e clique no ícone 删除, em seguida, clique em OK.

    image

Endpoint de conexão direta de nó

  1. Acesse a página Instances. Na barra de navegação superior, selecione a região em que a instância RDS está localizada. Em seguida, encontre a instância RDS e clique no ID dela.

  2. Na página Basic Information, na seção Instance Topology Management > Database Nodes, crie, visualize, modifique ou solicite um endpoint público para endpoints de conexão direta de nó.

    • Crie um endpoint de nó: Na área do nó de destino, clique em Create Node Endpoint, configure as informações de rede interna e, em seguida, clique em OK.

    • Visualize, modifique ou solicite um endpoint público para um endpoint de conexão direta de nó: Clique em Manage. Na caixa de diálogo exibida, use as opções Change Endpoint, Change VPC e Apply for para solicitar um endpoint público.

    image

FAQ

P: Preciso atualizar o endpoint ou a porta na minha aplicação após modificá-los?

R: Sim, atualize-os; caso contrário, a aplicação não conseguirá se conectar ao banco de dados.

P: A modificação de um endpoint ou porta entra em vigor imediatamente? Preciso reiniciar a instância?

R: Sim, entra em vigor imediatamente. Não é necessário reiniciar a instância.

P: Após modificar ou liberar um endpoint, posso reutilizar o endpoint original em outra instância?

R: Sim, é possível.

P: O endpoint da instância muda após um failover bem-sucedido?

R: Não, não muda. O endpoint permanece inalterado. Após o failover, a instância primária original torna-se uma instância secundária, e as aplicações se conectam automaticamente à nova instância primária (a instância secundária original).

P: Como resolvo o erro "Invalid connection string format" com o código de erro InvalidConnectionString.Malformed ao modificar um endpoint?

R: Este erro ocorre por um dos seguintes motivos:

  • Motivo 1: O SSL está ativado para a instância, o que causa falha na modificação do endpoint.

    Solução: Desativar a criptografia SSL e, em seguida, modifique o endpoint.

  • Motivo 2: A string de conexão modificada não atende aos requisitos — por exemplo, o prefixo do endpoint tem menos de 8 caracteres ou o comprimento total excede 63 caracteres.

    Solução: Otimize o endpoint modificado para atender a esses requisitos: O prefixo do endpoint deve começar com letra minúscula, terminar com letra minúscula ou dígito e conter apenas letras minúsculas, dígitos e hifens (-). Deve ter pelo menos 8 caracteres. O comprimento total do endpoint (prefixo + sufixo) não deve exceder 63 caracteres.

P: Por que o uso de CPU ou memória difere entre os nós em uma instância da Cluster Edition quando todos os pesos dos nós são iguais?

R: O Server Load Balancer (SLB) executa o balanceamento de carga com base no número de conexões, mas cada conexão consome quantidades diferentes de recursos de CPU ou memória.

P: Ajustar os pesos dos nós em uma instância da Cluster Edition afeta as conexões existentes? Causa indisponibilidade breve do serviço?

R: Não, não afeta. Ajustar os pesos dos nós afeta apenas novas conexões. As conexões existentes permanecem inalteradas e não há indisponibilidade do serviço.

P: Posso definir os pesos de todos os nós como 0 em uma instância da Cluster Edition?

R: Não. Pelo menos um nó deve ter um peso maior que 0.

P: Posso remover todos os nós de um endpoint em uma instância da Cluster Edition?

R: Não. Um endpoint somente leitura do cluster deve manter pelo menos um nó.

APIs relacionadas

API

Descrição

Criar um endpoint para uma instância

Cria um endpoint para uma instância da Cluster Edition do ApsaraDB RDS for MySQL.

Excluir um endpoint para uma instância

Exclui um endpoint para uma instância da Cluster Edition do ApsaraDB RDS for MySQL.

Modificar informações de conexão de endpoint para uma instância

Modifica as informações do endpoint para uma instância da Cluster Edition do ApsaraDB RDS for MySQL.