This article describes how to create, delete, or search for a group ID in the Message Queue for MQTT console.

Background information

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

Usage notes

  • Each group ID in an instance must be unique. A group ID 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, hyphen (-), and underscores (_).
  • A group ID is required for consumers but is optional for producers.

Create a group ID

  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 ID 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 ID on the Groups page.

Delete a group ID

Notice After you delete a group ID, the consumer instances that belong to the group ID stop receiving messages. The resources that belong to the group ID are also deleted and cannot be recovered. Therefore, exercise caution when you delete a group ID.
  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 ID in the instance list. In the Actions column, choose More > Groups.
  5. In the group ID list, find the group ID that you want to delete. In the Actions column, choose More > Delete.
  6. In the message that appears, click OK.
    On the Groups page, you cannot view the deleted group ID.

Query the details of a group ID

  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 a group ID in the instance list. In the Actions column, choose More > Groups.
  5. In the group ID list, find the group ID 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 ID.