Todos los productos
Search
Centro de documentos

ApsaraDB RDS:Manage instance endpoints and ports

Última actualización: Sep 03, 2026

Este tema describe cómo consultar y gestionar los endpoints y puertos de las instancias de ApsaraDB RDS for MySQL en la consola de ApsaraDB RDS.

Ediciones Basic y High-availability

Las instancias de las ediciones Basic y High-availability de ApsaraDB RDS for MySQL proporcionan los siguientes dos tipos de endpoints. Puede consultarlos o modificarlos según su escenario de conexión:

Tipo de endpoint

Descripción

Acciones

Endpoint de instancia

Un endpoint de instancia incluye un endpoint interno y un endpoint público:

  • Endpoint interno: Conéctese a su instancia de ApsaraDB RDS desde recursos dentro de la misma VPC, como una instancia de ECS. Este método ofrece baja latencia y alta estabilidad. El endpoint interno se genera automáticamente.

  • Endpoint público: Conéctese a su instancia de ApsaraDB RDS a través de Internet. Debe apply for a public endpoint manualmente.

Consulte las secciones siguientes para obtener información sobre cómo ver y modificar los endpoints y puertos internos y públicos.

Endpoint de proxy de base de datos

Si la función database proxy está habilitada para su instancia (compatible con instancias de la edición High-availability, pero no con las de la edición Basic), le recomendamos conectarse a la instancia mediante un endpoint de proxy de base de datos. Esto permite la división de lectura/escritura y reduce la carga en la instancia principal.

Consultar endpoints y puertos

  1. Vaya a la página Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. A continuación, localice la instancia de RDS y haga clic en el ID de la instancia.

  2. En la página Basic Information, dentro de la sección Basic Information, haga clic en View Details.

    Nota

    El endpoint público solo se muestra después de apply for a public endpoint.

    image.png

Modificar endpoints y puertos

Nota

Si ha habilitado el cifrado SSL para el endpoint interno o público de la instancia, primero debe disable SSL encryption antes de poder modificar el endpoint. Deshabilitar el cifrado SSL reinicia la instancia. Realice esta operación fuera del horario de mayor actividad.

  1. Vaya a la página Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. A continuación, localice la instancia de RDS y haga clic en el ID de la instancia.

  2. En el panel de navegación izquierdo, haga clic en Database Connection.

  3. Haga clic en Modify endpoint.image

  4. En el cuadro de diálogo, establezca el prefijo del endpoint y el número de puerto para el endpoint interno o público, y luego haga clic en OK.

    Nota

    El prefijo del endpoint debe ser único a nivel global.

Edición Cluster

Las instancias de la edición Cluster de ApsaraDB RDS for MySQL proporcionan un endpoint de lectura/escritura del clúster, un endpoint de solo lectura del clúster, un endpoint específico de nodo y un endpoint de proxy de base de datos. Puede consultarlos o modificarlos según su escenario de conexión:

Tipo de endpoint

Descripción

Acciones

Endpoint de lectura/escritura del clúster

Cada instancia tiene un solo endpoint de lectura/escritura. Este endpoint se conecta al nodo principal del clúster y admite operaciones de lectura y escritura. Incluye un endpoint interno generado automáticamente y un endpoint público que debe solicitar manualmente.

  • Endpoint interno: Se conecta a su instancia de ApsaraDB RDS desde recursos dentro de la misma VPC. Este método ofrece baja latencia y alta estabilidad. Por ejemplo, puede usar un endpoint interno para conectarse desde una instancia de ECS en la misma VPC.

  • Endpoint público: Se conecta a su instancia de ApsaraDB RDS a través de Internet.

Cluster read/write endpoint

Endpoint de solo lectura del clúster

Cada instancia puede tener un solo endpoint de solo lectura. Este endpoint se conecta a los nodos secundarios del clúster y admite balanceo de carga. Al crear un endpoint de solo lectura se genera automáticamente un endpoint interno. Debe solicitar manualmente un endpoint público.

El endpoint de solo lectura del clúster mantiene un número predefinido de nodos secundarios para garantizar la disponibilidad:

  • Si falla un nodo secundario asignado al endpoint de solo lectura, se reconstruye automáticamente.

  • Si un nodo secundario asignado al endpoint de solo lectura se promueve a nodo principal, se agrega automáticamente un nuevo nodo secundario al endpoint de solo lectura.

Cluster read-only endpoint

Endpoint específico de nodo

Se conecta directamente a un nodo especificado. El nodo principal admite operaciones de lectura y escritura, mientras que los nodos secundarios son de solo lectura.

Al crear un endpoint específico de nodo se genera automáticamente un endpoint interno. Debe solicitar manualmente un endpoint público.

Node-specific endpoint

Endpoint de proxy de base de datos

El database proxy de uso general está habilitado de forma predeterminada para las instancias de la edición Cluster. Puede configurar el endpoint de proxy para acceso de lectura/escritura o de solo lectura:

Endpoint de lectura/escritura del clúster

Un endpoint de lectura/escritura del clúster incluye un endpoint interno y un endpoint público. El endpoint interno se genera automáticamente cuando se crea la instancia. Puede solicitar un endpoint público según sea necesario.

  1. Vaya a la página Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. A continuación, localice la instancia de RDS y haga clic en el ID de la instancia.

  2. En la página Basic Information, dentro de la sección Instance Topology Management > Database Connection, puede consultar y modificar el endpoint de lectura/escritura del clúster, o solicitar un endpoint público.

    • Consultar el endpoint de lectura/escritura del clúster: Pase el cursor sobre el cuadro de conexión de lectura/escritura para ver sus detalles.

    • Modificar el endpoint de lectura/escritura del clúster o solicitar un endpoint público: Haga clic en Edit. En el cuadro de diálogo que aparece, puede Change endpoint, Change VPC o Apply for un endpoint público.

    image

Endpoint de solo lectura del clúster

Gestionar un endpoint de solo lectura

Nota
  • Crear o eliminar un endpoint de solo lectura del clúster no afecta al endpoint de lectura/escritura del clúster.

  • Al eliminar un endpoint de solo lectura del clúster, se liberan sus endpoints internos y públicos, y finalizan todas las conexiones de base de datos a este endpoint.

  • Cada instancia de la edición Cluster puede tener como máximo un endpoint de solo lectura del clúster. Varios nodos secundarios pueden equilibrar la carga a través de este único endpoint.

  1. Vaya a la página Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. A continuación, localice la instancia de RDS y haga clic en el ID de la instancia.

  2. En la página Basic Information, dentro de la sección Instance Topology Management > Database Connection, elija una de las siguientes acciones:

    • Agregar endpoint

      Haga clic en Add endpoint. En el cuadro de diálogo que aparece, introduzca o seleccione el prefijo del endpoint interno, el puerto del endpoint interno, la VPC y el vSwitch. Agregue los nodos secundarios a los que desea otorgar acceso y luego haga clic en OK.

    • Eliminar endpoint

      En el cuadro de conexión de solo lectura objetivo, haga clic en Delete. En el cuadro de diálogo de confirmación que aparece, haga clic en OK.

  3. Consultar el endpoint de solo lectura del clúster: En la página Basic Information, dentro de la sección Instance Topology Management > Database Connection, pase el cursor sobre el cuadro de conexión de solo lectura para ver sus detalles.

    image

Ajustar la configuración de nodos

Nota
  • Agregar nodos secundarios o ajustar pesos de nodos: Esta acción no afecta las conexiones de base de datos existentes. Las nuevas conexiones al endpoint de solo lectura del clúster se equilibran según la nueva configuración de nodos.

  • Quitar nodos secundarios: Debe mantener al menos un nodo secundario. Las conexiones de base de datos al nodo eliminado se desconectan temporalmente durante 30 a 120 segundos. Los demás nodos no se ven afectados.

  • Al ajustar los pesos de los nodos, al menos un nodo secundario debe tener un peso mayor que 0.

  • La configuración de nodos del endpoint de solo lectura del clúster se aplica tanto a sus endpoints internos como públicos.

  1. Vaya a la página Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. A continuación, localice la instancia de RDS y haga clic en el ID de la instancia.

  2. En la página Basic Information, dentro de la sección Instance Topology Management > Database Connection, haga clic en Edit en el cuadro de conexión de solo lectura:

    image

    • Agregar nodos y ajustar pesos: Seleccione los nodos secundarios que se agregarán al endpoint y haga clic en el icono 加入. Ajuste los pesos de los nodos y luego haga clic en OK.

    • Quitar nodos: Seleccione los nodos que se quitarán, haga clic en el icono 删除 y luego haga clic en OK.

    image

Endpoint específico de nodo

  1. Vaya a la página Instances. En la barra de navegación superior, seleccione la región donde reside la instancia de RDS. A continuación, localice la instancia de RDS y haga clic en el ID de la instancia.

  2. En la página Basic Information, dentro de la sección Instance Topology Management > Database Nodes, puede crear, consultar o modificar endpoints específicos de nodo, o solicitar endpoints públicos.

    • Crear un endpoint específico de nodo: En el área del nodo objetivo, haga clic en Create node endpoint, configure la información de red interna y luego haga clic en OK.

    • Consultar o modificar un endpoint específico de nodo, o solicitar un endpoint público: Haga clic en Manage. En el cuadro de diálogo que aparece, puede Change endpoint, Change VPC o Apply for un endpoint público.

    image

Preguntas frecuentes

P: Después de modificar un endpoint o puerto, ¿necesito actualizar la información de conexión en mi aplicación?

R: Sí. Debe actualizar la cadena de conexión de su aplicación para usar el nuevo endpoint o puerto.

P: ¿Los cambios en un endpoint o puerto surten efecto inmediatamente? ¿Requieren reiniciar la instancia?

R: Los cambios surten efecto inmediatamente y no requieren reiniciar la instancia.

P: Después de modificar o liberar un endpoint, ¿puedo usar el endpoint anterior para otra instancia?

R: Sí. Una vez que se libera un prefijo de endpoint, queda disponible para su uso.

P: ¿Un cambio de rol principal/secundario modifica los endpoints de la instancia?

R: No. Los endpoints permanecen sin cambios. Durante un cambio de rol, el tráfico se redirige automáticamente al nuevo nodo o instancia principal.

P: ¿Cómo resuelvo el error "Invalid endpoint format" (InvalidConnectionString.Malformed) al modificar un endpoint?

R: Este error ocurre principalmente por dos razones:

  • Reason 1: The endpoint modification fails because Secure Sockets Layer (SSL) is enabled for the instance.

    Solution: Enable SSL link encryption by using a cloud certificate y, a continuación, modifique el endpoint.

  • Reason 2: El endpoint modificado no cumple con los requisitos. Por ejemplo, el prefijo del endpoint tiene menos de 8 caracteres o la longitud total supera los 63 caracteres.

    Solution: Modifique el endpoint para cumplir con los siguientes requisitos: El prefijo del endpoint debe comenzar con una letra minúscula, terminar con una letra minúscula o un dígito, contener letras minúsculas, dígitos y guiones (-), y tener una longitud mínima de 8 caracteres. La longitud total del endpoint (prefijo + sufijo) no puede exceder los 63 caracteres.

P: En una instancia de la edición Cluster, ¿por qué difiere la utilización de CPU o memoria entre nodos incluso cuando sus pesos son iguales?

R: Server Load Balancer (SLB) distribuye el tráfico según el número de conexiones, no según la carga de trabajo de cada conexión. Por lo tanto, la utilización de CPU y memoria puede diferir incluso si el recuento de conexiones está equilibrado.

P: En una instancia de la edición Cluster, ¿ajustar los pesos de los nodos afecta las conexiones existentes? ¿Causa interrupción del servicio?

R: No. Esta acción no afecta las conexiones existentes ni causa interrupciones del servicio. Los nuevos pesos se aplican únicamente a las nuevas conexiones.

P: En una instancia de la edición Cluster, ¿puedo establecer los pesos de todos los nodos en 0?

R: No. Al menos un nodo debe tener un peso mayor que 0.

P: En una instancia de la edición Cluster, ¿puedo quitar todos los nodos de un endpoint?

R: No. Un endpoint de solo lectura del clúster debe contener al menos un nodo.

Referencia de API

API

Descripción

CreateDBInstanceEndpoint - Create an endpoint for an instance

Crea un endpoint para una instancia de la edición Cluster de ApsaraDB RDS for MySQL.

DeleteDBInstanceEndpoint - Delete an endpoint for an instance

Elimina un endpoint de una instancia de la edición Cluster de ApsaraDB RDS for MySQL.

ModifyDBInstanceEndpointAddress - Modify the endpoint information of an instance

Modifica la información del endpoint de una instancia de la edición Cluster de ApsaraDB RDS for MySQL.