Todos los productos
Search
Centro de documentos

ApsaraMQ for RocketMQ:Gestión de topics

Última actualización: Sep 04, 2026

En Message Queue for Apache RocketMQ, un topic es la categoría principal de los mensajes. Message Queue for Apache RocketMQ utiliza el modelo de publicación-suscripción, en el que los productores publican mensajes en topics y los consumidores se suscriben a dichos topics para recibirlos. Este artículo describe cómo crear, eliminar, actualizar y consultar topics en la consola de Message Queue for Apache RocketMQ.

Notas de uso

  • Un topic está aislado dentro de una instancia y no se puede utilizar en distintas instancias. Por ejemplo, un topic creado en la instancia A no se puede usar en la instancia B.

  • El tipo de mensaje de un topic debe coincidir con los mensajes que procesará. Por ejemplo, si crea un topic para enviar y recibir mensajes normales, su tipo de mensaje debe establecerse en Normal Message. No puede utilizarlo para otros tipos de mensaje, como mensajes ordenados por partición o mensajes transaccionales. De lo contrario, pueden surgir problemas, como la pérdida de mensajes programados durante el reemplazo de nodos o la migración de instancias.

Facturación

Message Queue for Apache RocketMQ cobra una tarifa por uso de recursos para cada topic, incluso si este no se utiliza. Se recomienda eliminar los topics que no estén en uso. Para obtener más información, consulte Messaging pricing details y Enterprise Platinum Edition billing.

Convenciones de nomenclatura de topics

  • El nombre de un topic debe tener entre 3 y 64 caracteres, y solo puede contener letras, dígitos, guiones (-) y guiones bajos (_).

  • Si la instancia del topic tiene un espacio de nombres, su nombre debe ser único dentro de esa instancia y no puede coincidir con un nombre de topic o ID de grupo existente. Los nombres pueden duplicarse en distintas instancias. Por ejemplo, un topic en la instancia A puede tener el mismo nombre que un topic o un ID de grupo en la instancia B.

  • Si la instancia del topic no tiene un espacio de nombres, su nombre debe ser único a nivel global en todas las instancias y regiones, y no puede coincidir con ningún nombre de topic o ID de grupo existente.

Nota

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

Crear un topic

  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, por ejemplo, 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 Topics. En la esquina superior izquierda de la página, haga clic en Create Topic.

  4. En el panel Create Topic, introduzca un Name y una Description, seleccione un Message Type para el topic y haga clic en OK.

    Importante

    Un topic solo puede procesar el tipo de mensaje especificado durante su creación. Por ejemplo, si crea un topic con el tipo de mensaje establecido en Normal Message, solo podrá usarlo para enviar y recibir mensajes normales. No puede utilizar este topic para mensajes ordenados. Para obtener más información, consulte Message types.

    El Name debe tener entre 3 y 64 caracteres, y solo puede contener letras, dígitos, guiones (-) y guiones bajos (_). El Commodity Type se establece automáticamente en pay-as-you-go. Message Type incluye cuatro opciones: Normal Message, Transactional Message, Partitioned Ordered Message y Scheduled/Delayed Message.

Eliminar un topic

Aviso

Después de eliminar un topic, sus productores y consumidores asociados dejan de funcionar inmediatamente. Los metadatos del topic y los datos de los mensajes también se eliminan y no se pueden restaurar. Proceda con precaución.

  1. En la página Instances, haga clic en el nombre de la instancia de destino. En el panel de navegación izquierdo, haga clic en Topics.

  2. En la lista de topics, localice el topic que desea eliminar. En la columna Actions, haga clic en More y seleccione Delete en el menú desplegable.

  3. En el cuadro de diálogo de confirmación, haga clic en OK.

Actualizar un topic

  1. En la página Instances, haga clic en el nombre de la instancia de destino. En el panel de navegación izquierdo, haga clic en Topics.

  2. En la lista de topics, localice el topic que desea actualizar. En la columna Actions, haga clic en Details para abrir la página Topic Details.

  3. En la sección Basic Information, haga clic en Edit junto a Topic Description. Introduzca la nueva descripción y haga clic en OK.

Consultar un topic

  1. En la página Instances, haga clic en el nombre de la instancia de destino. En el panel de navegación izquierdo, haga clic en Topics.

  2. En la lista de topics, haga clic en el nombre del topic o en Details en su columna Actions.

API relacionadas

También puede utilizar las siguientes operaciones de API para gestionar topics: