This topic describes how to create and delete groups, and query group details in the Message Queue for MQTT console.

Background information

A group ID specifies the name of a group of nodes (devices) with identical logic and features. You must create a group in the Message Queue for MQTT console before you can use it.

Usage notes

  • Group IDs must be unique within an instance, but can be repeated in different instances.
  • A group ID must start with "GID_" or "GID-" and must be 7 to 64 characters in length. It can contain only letters, digits, hyphens (-), and underscores (_).

Create a group

  1. Log on to the Message Queue for MQTT console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region.
  4. Find the instance for which you want to create a group in the instance list. In the Actions column, choose More > Groups.
  5. In the upper-left corner of the Groups page, click Create Group.
  6. In the Create Group panel, set the Group ID parameter and click OK.
    You can view the created group on the Groups page.

Delete a group

Notice After you delete a group, disconnected producers and consumers of this group ID fail the authentication when they attempt to reconnect to Message Queue MQTT. The deletion operation does not affect clients that are connected to Message Queue MQTT.
  1. Log on to the Message Queue for MQTT console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region.
  4. Find the instance for which you want to delete a group in the instance list. In the Actions column, choose More > Groups.
  5. In the group list, find the group that you want to delete. In the Actions column, choose More > Delete.
  6. On the dialog box that appears, click OK.
    On the Groups page, you cannot view the deleted group.

Query the details of a group

  1. Log on to the Message Queue for MQTT console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region.
  4. Find the instance for which you want to query group details in the instance list. In the Actions column, choose More > Groups.
  5. In the group list, find the group that you want to query. Click the group ID or click Details in the Actions column to go to the Group Details page.
    On the Group Details page, you can query the details of the specified group.