Todos los productos
Search
Centro de documentos

ApsaraMQ for Kafka:Actualizar la configuración de una instancia

Última actualización: Oct 10, 2026

Actualice la edición, el tráfico, la capacidad de disco, las particiones o el tipo de red de una instancia de ApsaraMQ for Kafka desde la consola.

Requisitos previos

Compruebe lo siguiente:

  • La instancia se encuentra en el estado Running o Not Deployed.

  • No hay tareas de reequilibrio de tráfico en curso en la instancia.

Escenarios y riesgos de actualización

Scenario

Risk

Aumentar la capacidad de disco de una instancia que no es serverless

Los brokers del clúster se reinician uno por uno.

Actualizar la especificación de tráfico de una instancia que no es serverless

Los brokers del clúster se reinician uno por uno.

Cambiar de Standard Edition a Professional Edition (High Write) o Professional Edition (High Read)

Los brokers del clúster se reinician uno por uno.

Agregar un endpoint público a una instancia conectada mediante VPC

Los brokers del clúster se reinician uno por uno.

Cambiar el tipo de red de Internet and VPC a VPC

Los brokers del clúster se reinician uno por uno.

Modificar el ancho de banda público de una instancia que no es serverless

Los brokers del clúster se reinician uno por uno.

Modificar la cantidad de particiones o temas de una instancia que no es serverless. Las instancias adquiridas a partir del 26 de agosto de 2022 solo admiten cambios de particiones. Las instancias adquiridas antes de esa fecha solo admiten cambios de temas.

Ninguna.

Reducir la especificación de uso mínimo de una instancia serverless

El escalado automático se suspende después de la actualización.

Qué ocurre cuando se reinician los brokers

Las actualizaciones que provocan el reinicio de los brokers tienen el siguiente impacto:

  • Desconexiones temporales. Los clientes pueden desconectarse y reconectarse brevemente, lo que genera errores ocasionales.

  • Errores al enviar mensajes. Los mensajes enviados durante la actualización podrían fallar. Habilite los reintentos en el cliente para reenviar los mensajes con errores. Los mensajes enviados correctamente antes de la actualización se conservan.

  • Reasignación de particiones. Los servicios continúan funcionando, pero algunos mensajes pueden dirigirse a una partición distinta.

  • Actualizaciones del security group. Las actualizaciones de tráfico pueden escalar horizontalmente el clúster. Si se agregan nuevos brokers, actualice el security group del cliente para permitir el acceso a sus direcciones IP.

En las instancias serverless, el escalado automático se suspende durante las actualizaciones o reducciones de recursos. Programe estos cambios en periodos de tráfico estable.

Duración estimada de la actualización

Instance specification

Estimated duration

alikafka.hr.30xlarge o inferior, alikafka.hw.30xlarge o inferior

Aproximadamente 30 minutos

alikafka.hr.60xlarge o superior, alikafka.hw.60xlarge o superior

Más de 1 hora

La duración aumenta de forma lineal según la especificación de la instancia. Un incremento mayor en la capacidad de disco también prolonga el tiempo de actualización. Programe las actualizaciones fuera del horario de mayor demanda.

  • Enviar una solicitud de actualización no afecta al clúster existente hasta que se complete el pago y el pedido entre en vigor. La actualización comienza únicamente cuando el pedido se vuelve efectivo.

  • Para las instancias de suscripción, el cargo generado por actualizar la configuración de la instancia (como ampliar la capacidad de disco o mejorar la especificación de tráfico) corresponde a una diferencia de precio única. No representa un cobro mensual recurrente.

Actualizar una instancia

  1. Inicie sesión en la consola de ApsaraMQ for Kafka. En la página Overview, seleccione una región en la sección Resource Distribution.

  2. En la página Instances, haga clic en el nombre de la instancia de destino.

  3. En la página Instance Details, haga clic en Upgrade en la esquina superior derecha de la sección Overview.

  4. En el cuadro de diálogo Instance Upgrade Risks, lea la descripción de los riesgos y haga clic en OK.

  5. En el panel de cambio de configuración, configure los siguientes parámetros.

    Parámetro

    Descripción

    Instance Edition

    Admite la actualización de Standard Edition a Professional Edition. Tenga en cuenta lo siguiente al cambiar de Standard Edition a Professional Edition:

    • La capacidad de disco no cambia tras la actualización. Por ejemplo, si la capacidad original es de 1,000 GB, seguirá siendo de 1,000 GB después del proceso.

    • La capacidad de almacenamiento de copias de seguridad deja de incluirse como elemento de facturación una vez completada la actualización.

    • Después de la actualización, puede configurar la duración de retención de mensajes para cada tema de forma individual.

    • Esta actualización es irreversible. No se admite volver de Professional a Standard. Si actualiza la configuración directamente y la consola devuelve el mensaje de error "can not change specType", significa que la instancia no admite una actualización directa de Standard a Professional. En este caso, utilice la siguiente solución de migración:

      1. Cree una nueva instancia Professional.

      2. Utilice Cluster Linking o una herramienta de migración propia para trasladar los datos de la instancia original a la nueva.

      3. Una vez que haya cambiado el tráfico de su negocio a la nueva instancia, libere la instancia Standard original.

    También permite aumentar la especificación de tráfico de Professional Edition a una superior. No admite reducir Professional Edition a Standard Edition, ni realizar actualizaciones cruzadas entre Open Source Edition (disco local) y otros tipos de especificaciones. Para obtener información sobre los tipos de especificaciones de instancia y sus precios, consulte Billing overview.

    Network Type

    Permite alternar entre VPC e Internet and VPC.

    Public Traffic

    El tráfico de Internet incluye lectura y escritura con el mismo rendimiento máximo. Seleccione una especificación basada en el valor pico más alto (lectura o escritura). Este parámetro solo se factura en instancias de Internet and VPC.

    Nota

    ApsaraMQ for Kafka calcula el ancho de banda óptimo según el tipo de instancia. Adquiera el tráfico de Internet tal como se indica en la página de compra para evitar limitaciones de velocidad.

    Traffic Specification

    Detalles de la especificación de tráfico.

    Disk Capacity

    La capacidad de disco predeterminada varía según la especificación de tráfico y se ajusta automáticamente cuando esta cambia. Modifíquela según sea necesario. Si la actualización de la especificación de tráfico provoca un escalado horizontal del clúster (por ejemplo, pasar de 3 nodos × 30 MB/s a 3 nodos × 60 MB/s), la capacidad de almacenamiento de los nuevos nodos debe coincidir con la de los existentes, por lo que la capacidad de disco se duplica en consecuencia. Si la capacidad de disco actual es inferior al valor mínimo recomendado por el sistema, deberá aumentarla por encima de dicho valor antes de completar la actualización.

    Partitions

    Total de particiones = particiones adquiridas + particiones gratuitas incluidas en la especificación. Temas disponibles = total de particiones. Grupos de consumidores disponibles = total de particiones × 2.

    Cuando actualiza la especificación de tráfico (por ejemplo, a alikafka.hr.16xlarge), el sistema otorga automáticamente la cantidad de particiones correspondiente a la nueva especificación (por ejemplo, 2,000 particiones). No necesita ajustar manualmente la cantidad de particiones ni adquirir particiones adicionales.

    Nota

    Desde el 26 de agosto de 2022, ya no se admite la actualización de instancias adquiridas con especificación por temas. Topic, group, and partition quotas of an instance purchased by topic.

  6. Lea y acepte los términos de servicio, y luego haga clic en Create Now.

Detalles de la especificación de tráfico

Las actualizaciones de la especificación de tráfico dependen de la edición de la instancia y del tipo de disco.

Límites de tráfico por edición:

Edition

Peak throughput

Standard Edition

Hasta 120 MB/s de lectura o escritura

Professional Edition (High Write)

Hasta 2,000 MB/s de escritura

Professional Edition (High Read)

Hasta 3,000 MB/s de lectura y hasta 1,000 MB/s de escritura

Nota

Para seleccionar una especificación de tráfico con una tasa pico de lectura o escritura superior a 120 MB/s, primero debe actualizar a Professional Edition.

Escalado horizontal del clúster según el tipo de disco:

Algunas actualizaciones de tráfico provocan un escalado horizontal del clúster. Una vez finalizado, reequilibre el tráfico de los temas. Rebalance topic traffic.

Disk type

Scale-out trigger

Ultra disk

Especificación de tráfico con una tasa pico de lectura o escritura de hasta 120 MB/s

SSD

Especificación de tráfico con una tasa pico de lectura o escritura de hasta 300 MB/s

Comprobar la actualización

Después de generar el pedido de actualización, la hora de entrada en vigor aparece en la página del pedido.

En la sección Basic Information de la página Instance Details, el campo Status cambia a Upgrading. Cuando finaliza el proceso, la página muestra las nuevas configuraciones.

Preguntas frecuentes

¿Puedo aumentar únicamente el ancho de banda de la red pública sin modificar la especificación de la instancia?

Sí. Para las instancias que no son serverless, puede ir al panel Upgrade en la consola y ajustar solo el parámetro Internet Traffic para incrementar el ancho de banda de la red pública sin alterar la especificación de la instancia.

Nota

Esta operación constituye una actualización y provoca un reinicio gradual del clúster. Durante el reinicio, los clientes pueden experimentar desconexiones y reconexiones breves, y la entrega de mensajes en las particiones podría perder temporalmente el orden. Ejecute esta operación fuera del horario de mayor actividad del negocio.

¿Por qué no se muestra la opción Endpoints en la consola?

Si la opción Endpoints no aparece en la página de detalles de la instancia, generalmente se debe a que la instancia está conectada mediante VPC y no tiene habilitado el acceso a la red pública, o bien reside en una región que no admite dicho acceso, como las regiones de Alibaba Finance Cloud. Para obtener un endpoint público, siga el procedimiento de Upgrade descrito en este tema y cambie el tipo de red a Internet and VPC, de modo que la instancia quede conectada tanto a Internet como a la VPC.

¿Por qué aumenta el uso de ancho de banda en un nodo después de ampliar el ancho de banda de la red pública?

Este comportamiento es normal y puede deberse a las siguientes razones:

  • Alcance de la métrica: el uso del ancho de banda de la red pública se mide con base en la dirección IP elástica (EIP), lo cual incluye tráfico de gestión como latidos (heartbeats) y confirmaciones de desplazamiento (offset commits). En cambio, las métricas de tráfico del servicio solo contabilizan el envío y la recepción de mensajes.

  • Diferencia de unidades: el ancho de banda de la red pública se mide en bit/s, mientras que el tráfico del servicio se mide en B/s. Dado que 1 byte equivale a 8 bits, ambas métricas pueden diferir por un factor de 8 incluso para la misma cantidad de tráfico.

  • Mayor capacidad de consumo: al elevar el límite de ancho de banda, los clientes pueden consumir mensajes más rápido, lo que incrementa el uso real del ancho de banda.

  • Mayor tolerancia a picos: cuando adquiere más ancho de banda, también aumenta la tolerancia del servidor ante picos de tráfico que superan la especificación comprada. Esto puede reflejarse en un uso observado más alto durante los incrementos repentinos de tráfico.