Todos los productos
Search
Centro de documentos

ApsaraMQ for RocketMQ:Gestión de grupos

Última actualización: Sep 21, 2026

Un grupo identifica las instancias productoras o consumidoras que procesan el mismo tipo de mensaje con una lógica compartida. Cree los grupos en la consola de ApsaraMQ for RocketMQ antes de usar ApsaraMQ for RocketMQ para producir o consumir mensajes.

Límites

  • Se admiten hasta 1,000 grupos por instancia. Reutilice o elimine los grupos que no use para mantenerse dentro del límite. Si necesita aumentar esta cuota, comuníquese con el soporte técnico de ApsaraMQ for RocketMQ.

  • No es posible utilizar un grupo en varias instancias.

  • ApsaraMQ for RocketMQ es compatible con los protocolos HTTP y TCP para el consumo de mensajes. Cada grupo puede usar un protocolo distinto, pero todos los consumidores dentro de un mismo grupo deben emplear el mismo.

    • Combinar protocolos dentro de un grupo puede provocar fallos de consumo, duplicación o pérdida de mensajes.

    • Los cambios de protocolo de un grupo tardan entre 1 y 2 horas aproximadamente en surtir efecto.

    • Si el protocolo real difiere del que se muestra en la consola, los datos de esta podrían ser inexactos, aunque la mensajería no se ve afectada. Comuníquese con el soporte técnico de ApsaraMQ for RocketMQ para actualizar el protocolo mostrado.

  • El identificador de grupo es obligatorio para cada consumidor, pero opcional para los productores.

Convenciones de nomenclatura para los identificadores de grupo

  • El identificador de grupo debe tener entre 2 y 64 caracteres. Puede contener letras, dígitos, guiones (-) y guiones bajos (_). Se recomienda usar el prefijo GID_ o GID-.

  • Si la instancia tiene un namespace, el identificador de grupo debe ser único dentro de ella. No puede coincidir con ningún identificador de grupo ni nombre de topic existente. Los identificadores de distintos grupos pueden repetirse entre instancias diferentes.

  • Si la instancia no tiene un namespace, el identificador de grupo debe ser único a nivel global en todas las instancias y regiones de su cuenta de Alibaba Cloud. Tampoco puede coincidir con ningún identificador de grupo ni nombre de topic existente.

Nota

Para comprobar si una instancia tiene un namespace, vaya a la página Instance Details en la consola de Message Queue for Apache RocketMQ y consulte la sección Basic Information.

Creación de un grupo de consumidores

  1. Inicie sesión en la consola de ApsaraMQ for RocketMQ

    . En el panel de navegación izquierdo, haga clic en Instances.

  2. En la barra de navegación superior, seleccione una región, como China (Hangzhou). En la página Instances, haga clic en el nombre de la instancia que desea gestionar.

  3. En el panel de navegación izquierdo, haga clic en Groups.

  4. En la página Groups, seleccione un protocolo para su SDK cliente y haga clic en Create Group.

    ApsaraMQ for RocketMQ admite TCP y HTTP para los SDK cliente.

  5. En el panel que aparece, establezca el Group ID y la Description, y luego haga clic en OK.

Eliminación de un grupo

Aviso

Al eliminar un grupo, las instancias consumidoras asociadas a ese identificador dejan de recibir mensajes. Los recursos del grupo se eliminan de forma permanente y no se pueden restaurar.

  1. En la página Instances, haga clic en el nombre de la instancia que desea gestionar. En el panel de navegación izquierdo de la página que aparece, haga clic en Groups.

  2. En la lista de grupos, busque el grupo que desea gestionar, haga clic en More en la columna Actions y seleccione Delete en la lista desplegable.

  3. En el mensaje que aparece, haga clic en OK.

Consulta de los detalles de un grupo

  1. En la página Instances, haga clic en el nombre de la instancia que desea gestionar. En el panel de navegación izquierdo de la página que aparece, haga clic en Groups.

  2. En la lista de grupos, busque el grupo correspondiente y haga clic en su identificador o en Details dentro de la columna Actions para abrir la página de detalles del grupo.

Más operaciones

La página Groups también permite ejecutar las siguientes operaciones:

  1. En el panel de navegación izquierdo, haga clic en Groups.

  2. En la lista de grupos, busque el grupo que desea gestionar, haga clic en More en la columna Actions y seleccione una de las siguientes operaciones en la lista desplegable:

  • Quick Access: consulte las referencias del SDK de ApsaraMQ for RocketMQ para varios lenguajes de programación.

  • Reset Consumer Offset: restablezca el desplazamiento del consumidor para omitir mensajes acumulados o no deseados e iniciar el consumo desde un nuevo punto. También es posible consumir mensajes a partir de un momento específico, sin importar si los anteriores ya se consumieron. Para obtener más información, consulte Reset consumer offsets.

  • Cloud Monitor: revise los datos de monitoreo de producción y consumo del grupo.

  • Dashboard: examine las métricas de consumo del grupo.

Referencias

También puede gestionar los grupos mediante las siguientes llamadas a la API: