设备群组 V2

更新时间:2024-07-02 03:26:49下载pdf

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

场景示例

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

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

  • 统一打开或关闭灯组的灯
  • 调整灯组的亮度
  • 单独控制每个灯组

业务流程

具体的使用流程如下:

设备群组 V2

名词解释

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

API 列表

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 个

其他说明

  • 设备群组 2.0 API 由于其历史原因,目前已不推荐使用,新接入用户推荐使用 设备群组 2.1 API
  • 设备群组 2.1 API 完全覆盖了设备群组 2.0 API 的能力,用户在设备群组 2.0 API 创建的群组在设备群组 2.1 API 仍然可以使用。