IoT Platform allows you to group devices. You can use device groups to manage devices across products. This article describes how to create and manage device groups in the IoT Platform console.

Background information

  • Each group can have up to 100 subgroups.
  • Groups can be nested in only three layers, which are groups, subgroups, and child subgroups.
  • Each subgroup belongs to only one parent group.
  • You can create or delete the nested relationship of groups, but cannot modify the nested relationship.
  • You cannot delete a group that has one or more subgroups. To delete a parent group, you must first delete all of its subgroups.
  • You can search for parent groups and subgroups by name. Fuzzy search is supported.

Procedure

  1. Log on to the IoT Platform console.
  2. In the left-side navigation pane, choose Devices > Groups. The Groups page appears.
  3. Click Create Group. In the Create Group dialog box, set the parameters and click OK.
    Note Each Alibaba Cloud account can create up to 1,000 groups, which include parent groups and subgroups.
    Device groups

    Set the following parameters as required:

    • Parent Group: the type of the group to be created.
      • If you select Groups, the group to be created is a parent group.
      • If you select a specific group, the group to be created is a subgroup of the selected group.
    • Group Name: the name of the group to be created. The name must be 4 to 30 characters in length, and can contain Chinese characters, letters, Japanese characters, digits, and underscores (_). Each Chinese character or Japanese character uses two characters. The group name must be unique within your Alibaba Cloud account and cannot be modified after it is created.
    • Group Description: the description of the group. This parameter is optional.
  4. On the Groups page, find the group that you created and click View in the Actions column. The Group Details page appears.
  5. Optional. Add a tag to the group. A tag is a custom group identifier. This allows you to flexibly manage the group. For more information, see Group tag.
  6. Click the Device List tab. Then, click Add Device to Group. In the Add Device to Group panel, search for and select one or more devices and click OK to add the one or more devices to the group.
    Note
    • You can add up to 1,000 devices at a time. You can add up to 20,000 devices to each group.
    • Each device can be added to up to 10 groups.

    After you add the devices to the group, you can search for the devices on the Device List tab:

    • If you select All, the tab displays all the devices in the group that belong to all the products within your Alibaba Cloud account. Fuzzy search is supported. You can enter a keyword to search for devices. For example, if you enter the keyword test, the search results may be the devices named test1, test2, and test3 within your Alibaba Cloud account.
    • If you select a specific product, the tab displays all the devices in the group that belong to the selected product. Fuzzy search is supported. You can enter a keyword to search for devices.
    In the Add Device to Group panel, you can click All or Selected in the upper-right corner:
    • After you click All, all the devices are displayed in the list.
    • After you click Selected, only the selected devices are displayed in the list.
  7. Optional. On the Group Details page, click the Subgroups tab. Then, click Create Group and create a subgroup for the group.

    Subgroups are used for finer-grained device management. For example, for a group named Smart_home, you can create subgroups such as Smart_kitchen and Smart_bedroom. This helps you separately manage kitchen equipment and bedroom equipment. Perform the following steps:

    1. In the Create Group dialog box, select a parent group, enter a name and a description for the subgroup, and then click OK.
    2. On the Subgroups tab, find the subgroup that you created and click View in the Actions column. The Group Details page of the subgroup appears.
    3. Click the Device List tab. Then, click Add Device to Group and add devices to the subgroup.
    After you create the subgroup and add devices to the subgroup, you can manage the subgroup and the devices in it. You can also create child subgroups for the subgroup.