Tous les produits
Search
Centre de documentation

ApsaraMQ for RocketMQ:Gérer les groupes

Dernière mise à jour :Sep 21, 2026

Un groupe identifie les instances de producteurs ou de consommateurs qui traitent le même type de message selon une logique partagée. Créez des groupes dans la console ApsaraMQ for RocketMQ avant d'utiliser ApsaraMQ for RocketMQ pour produire ou consommer des messages.

Limites

  • Limite de 1 000 groupes par instance. Réutilisez ou supprimez les groupes inutilisés pour respecter cette limite. Pour augmenter ce quota, contactez le support technique ApsaraMQ for RocketMQ.

  • Un groupe ne peut pas être partagé entre plusieurs instances.

  • ApsaraMQ for RocketMQ prend en charge les protocoles HTTP et TCP pour la consommation de messages. Différents groupes peuvent utiliser des protocoles différents, mais tous les consommateurs d'un même groupe doivent utiliser le même protocole.

    • Le mélange de protocoles au sein d'un groupe peut entraîner des échecs de consommation, une duplication ou une perte de messages.

    • La modification du protocole d'un groupe prend environ 1 à 2 heures pour être effective.

    • Si le protocole réel diffère de celui affiché dans la console, les données de la console peuvent être inexactes, mais la messagerie reste fonctionnelle. Contactez le support technique ApsaraMQ for RocketMQ pour mettre à jour le protocole affiché.

  • Un ID de groupe est obligatoire pour chaque consommateur, mais facultatif pour les producteurs.

Conventions de nommage des ID de groupe

  • Un ID de groupe doit comporter entre 2 et 64 caractères et peut contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_). Préfixe recommandé : GID_ ou GID-.

  • Si l'instance dispose d'un namespace, l'ID de groupe doit être unique au sein de cette instance et ne peut pas être identique à un ID de groupe ou un nom de topic existant. Les ID de groupe peuvent être identiques sur différentes instances.

  • Si l'instance ne dispose pas de namespace, l'ID de groupe doit être globalement unique sur toutes les instances et régions de votre compte Alibaba Cloud. Il ne peut pas être identique à un ID de groupe ou un nom de topic existant.

Remarque

Pour vérifier si une instance possède un namespace, accédez à la page Instance Details dans la console Message Queue for Apache RocketMQ et consultez la section Basic Information.

Créer un groupe de consommateurs

  1. Connectez-vous à la console ApsaraMQ for RocketMQ. Dans le volet de navigation de gauche, cliquez sur Instances.

  2. Dans la barre de navigation supérieure, sélectionnez une région, par exemple China (Hangzhou). Sur la page Instances, cliquez sur le nom de l'instance à gérer.

  3. Dans le volet de navigation de gauche, cliquez sur Groups.

  4. Sur la page Groups, sélectionnez un protocole pour votre SDK client et cliquez sur Create Group.

    ApsaraMQ for RocketMQ prend en charge TCP et HTTP pour les SDK clients.

  5. Dans le panneau qui s'affiche, définissez l'Group ID et la Description, puis cliquez sur OK.

Supprimer un groupe

Avertissement

Après la suppression d'un groupe, les instances de consommateurs identifiées par cet ID de groupe cessent de recevoir des messages. Les ressources du groupe sont définitivement supprimées et ne peuvent pas être restaurées.

  1. Sur la page Instances, cliquez sur le nom de l'instance à gérer. Dans le volet de navigation de gauche de la page qui s'affiche, cliquez sur Groups.

  2. Dans la liste des groupes, recherchez le groupe à gérer, cliquez sur More dans la colonne Actions, puis sélectionnez Delete dans la liste déroulante.

  3. Dans le message qui s'affiche, cliquez sur OK.

Afficher les détails d'un groupe

  1. Sur la page Instances, cliquez sur le nom de l'instance à gérer. Dans le volet de navigation de gauche de la page qui s'affiche, cliquez sur Groups.

  2. Dans la liste des groupes, recherchez le groupe cible et cliquez sur son ID ou sur Details dans la colonne Actions pour ouvrir la page Group Details.

Autres opérations

La page Groups permet également d'effectuer les opérations suivantes :

  1. Dans le volet de navigation de gauche, cliquez sur Groups.

  2. Dans la liste des groupes, recherchez le groupe à gérer, cliquez sur More dans la colonne Actions, puis sélectionnez l'une des opérations suivantes dans la liste déroulante :

  • Quick Access : Consultez les références SDK ApsaraMQ for RocketMQ pour plusieurs langages de programmation.

  • Reset Consumer Offset : Réinitialisez l'offset du consommateur pour ignorer les messages accumulés ou indésirables et démarrer la consommation à partir d'un nouvel offset. Vous pouvez également consommer des messages à partir d'un moment précis, indépendamment de la consommation des messages antérieurs. Pour plus d'informations, consultez Réinitialiser les offsets des consommateurs.

  • Cloud Monitor : Consultez les données de surveillance de la production et de la consommation pour le groupe.

  • Dashboard : Consultez les métriques de consommation pour le groupe.

Références

Vous pouvez également gérer les groupes en appelant les opérations API suivantes :