Overview

Group

A group is a collection of devices. You can create groups for all the devices in a resource space based on different rules, such as regions and types, and you can operate the devices by group. For example, you can perform a firmware upgrade on a group of water meters in the resource space. Devices in a group can be added, deleted, modified, and queried. A device can be bound to and unbound from multiple groups.

Tag

You can define tags and bind tags to devices. Applications can call the API Querying Resources by Tag to query devices bound to a specific tag.

Limitations

• A maximum of 20,000 devices can be added to a group.
• A device can be bound to a maximum of 10 groups.

Managing a Group

1. Log in to the IoTDA console.
2. In the navigation pane, choose Devices > Groups.
3. Click the buttons to add or delete a group.
   

   Icon	Description
   	Add a root group. The group name and description can be customized.
   	Add a child group. The group name and description can be customized.
   	Delete a selected group. The deletion operation cannot be undone. The default group cannot be deleted. Before deleting a group, unbind devices from the group and delete its lower-level groups.

Binding or Unbinding a Device

After adding a group, you can bind a device to or unbind a device from the group, or move a device to a different group.

1. Log in to the IoTDA console.
2. In the navigation pane, choose Devices > Groups.
3. Select a group, click the Bound Devices tab, and click buttons to bind or unbind devices.
   

   Operation	Description
   Bind	Bind a device to a group.
   Unbind	Unbind a device from a group.

Tags

Tags are used to classify devices. You can bind tags to devices on the device details page.

1. Log in to the IoTDA console.
2. In the navigation pane, choose Devices > All Devices, and click View in the row of a device.
3. On the Tags tab page, click Bind Tags to bind one or more tags to the device.

   

APIs

Binding Tags

Unbinding Tags

Querying Resources by Tag

Querying a Device Group List

Adding a Device Group

Querying a Device Group

Modifying a Device Group

Deleting a Device Group

Managing Devices in a Device Group

Querying Devices in a Device group