设备群组

更新时间：2023-11-23 03:29:01下载pdf

设备群组 是一组具有相同功能设备的集合，让大量设备可以被视作一个整体进行管理和控制，例如开启、关闭、定时任务等。群组化的管理方式，实现了更加方便的设备组织和调度方式，提高操作效率，并降低管理成本。

场景示例

商业照明场景中，因为设备数量普遍较高，需要对大量的灯进行模块化管理和控制。

您可以将商业大楼中的所有灯进行编号，再依据建筑结构和灯具类型等因素将灯分组。例如，所有同种类，同楼层的灯可被分为一个灯组，每个灯组包含若干个灯。通过一次的操作，可实现：

具体的使用流程如下：

名词	常见字段	说明
设备	`device_id`	设备在云端的表示标识。
群组	`group_id`	创建设备群组后，在云端的表示标识。
产品	`product_id`	相似功能的设备集合。
空间	`space_id`	定义物联网设备的地理位置、区域、布局等空间信息，以及不同物联网设备之间的空间拓扑关系。更多详情请参考空间管理。

API	路径
删除群组	DELETE:/v2.0/cloud/thing/group/{group_id}
删除设备	DELETE:/v2.0/cloud/thing/group/{group_id}/devices
获取空间下群组	GET:/v2.0/cloud/thing/group
获取设备所在群组	GET:/v2.0/cloud/thing/group/device/{device_id}
查询群组	GET:/v2.0/cloud/thing/group/{group_id}
查询群组设备	GET:/v2.0/cloud/thing/group/{group_id}/devices
查询群组属性	GET:/v2.0/cloud/thing/group/{group_id}/properties
创建群组	POST:/v2.0/cloud/thing/group
下发群组属性	POST:/v2.0/cloud/thing/group/properties
添加设备	PUT:/v2.0/cloud/thing/group/{group_id}/devices
修改群组名称	PUT:/v2.0/cloud/thing/group/{group_id}/{name}

常用 API 的使用案例如下：

限制项	最高限制
单群组下设备数量	100 个
单空间下群组数量	50 个