Last Updated on : 2024-09-10 08:51:11
A device group is a collection of devices with the same features, allowing users to manage and control a large number of devices as a whole. For example, turn devices on or off, and create scheduled tasks. Group management makes it easier for you to organize and dispatch devices in a more efficient and cost-effective way.
In commercial lighting scenarios, you need to implement modularized management and control of many lights.
You can number all the lights in a commercial building and group them based on the building structure and light type. For example, all lights of the same type and on the same floor can be divided into a light group, and each light group contains several lights. With just a single tap, users can:
The following diagram describes how it works.
Term | Field | Description |
---|---|---|
Device | device_id |
The identifier of the specified device in the cloud. |
Group | group_id |
The identifier of the specified device group in the cloud. |
Product | product_id |
A collection of devices with similar functionalities. |
Space | space_id |
A space defines the geographical location, area, and layout information of IoT devices, and displays the topological relationship between various smart devices. For more information, see Space Management. |
API name | API endpoint |
---|---|
Delete Group | DELETE:/v2.0/cloud/thing/group/{group_id} |
Delete Devices | DELETE:/v2.0/cloud/thing/group/{group_id}/devices |
Get Groups in a Space | GET:/v2.0/cloud/thing/group |
Get Device Group | GET:/v2.0/cloud/thing/group/device/{device_id} |
Query Group | GET:/v2.0/cloud/thing/group/{group_id} |
Query Group Devices | GET:/v2.0/cloud/thing/group/{group_id}/devices |
Query Group Properties | GET:/v2.0/cloud/thing/group/{group_id}/properties |
Create Group | POST:/v2.0/cloud/thing/group |
Send Group Properties | POST:/v2.0/cloud/thing/group/properties |
Add Device | PUT:/v2.0/cloud/thing/group/{group_id}/devices |
Rename Group | PUT:/v2.0/cloud/thing/group/{group_id}/{name} |
The APIs often apply to the following scenarios.
Item | Limits |
---|---|
The maximum number of devices in one group | 100 |
The maximum number of groups in one space | 50 |
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedback