更新时间:2024-11-26 GMT+08:00

群组和标签

群组概述

群组是一系列设备的集合,用户可以对资源空间下所有设备,根据区域、类型等不同规则进行分类建立群组,以便处理对海量设备的批量操作。例如,对资源空间下所有水表设备的群组进行固件升级。平台支持群组的增删改查操作,支持给群组绑定和解绑设备,支持一个设备被添加到多个群组中。

表1 群组分类

群组类型

使用说明

静态群组

手动添加设备到群组以及从群组中移除设备;支持群组层级嵌套。

限制:

  • 账号下单实例最多可创建1,000个群组(包含嵌套的子群组)。
  • 一个群组内最多添加20,000个设备。
  • 一个设备最多可以被添加到10个群组中。
  • 群组嵌套关系最大5级。
  • 子群组只能归属一个父群组,不支持多父群组。
  • 当群组有子群组时不能直接删除,需要先删除子群组才能删除父群组。

动态群组

按照动态群组规则(设备查询条件,类SQL语句)动态的将符合条件的设备自动添加进群组,不符合条件的自动移除群组;不支持手动管理群组中的设备。

限制:

  • 账号下单实例最大可创建10个动态群组。
  • 首次创建动态群组,规则最多允许匹配的100,000个设备(增量加入群组的设备无限制)。
  • 动态群组默认为父群组,不支持将动态群组进行嵌套。
  • 动态群组创建成功后,不允许修改动态群组规则。
  • 不允许手动管理动态群组中的设备。
  • 仅标准版实例、企业版实例支持该接口调用,基础版不支持。
  • 单账号创建动态群组的 TPS 限制最大为1/S(每秒1次请求数)。

管理群组

  1. 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。
  2. 在左侧导航栏,选择设备 > 群组
  3. 单击相关按钮,进行添加群组、修改群组、删除群组操作。

    图1 设备-群组

静态群组

  1. 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。
  2. 在左侧导航栏,选择设备 > 群组
  3. 单击添加根群组,进行添加群组,群组类别选择“静态群组”,根据页面提示填写参数,完成后单击“确定”创建群组。

    图2 群组-创建静态群组

  4. 可以进入静态群组详情界面对群组下的设备进行绑定和解绑等操作,具体操作见表2

    图3 静态群组-绑定设备
    表2 操作说明

    操作

    操作说明

    绑定

    单击可绑定设备。

    批量解绑

    选中多个设备(一次最多选择100个),单击“批量解绑”按钮,可将选择的设备从当前群组中解绑。

    解绑

    选中设备后,单击“解绑”可将设备从群组中解绑。

  5. 可以到设备->所有设备,单击设备的“详情”,再在页面上方单击“群组”,可以查看当前设备加入的群组信息,并进行相关管理操作,具体操作见表2

    图4 设备-群组管理

动态群组

  1. 访问设备接入服务,单击管理控制台进入设备接入控制台。选择您的实例,单击实例卡片进入。
  2. 在左侧导航栏,选择设备 > 群组
  3. 单击“添加根群组”,进行添加群组,群组类型选择动态群组
  4. 根据页面提示填写参数,动态规则输入类SQL语句,单击“配置规则”可查看匹配的设备列表,完成后单击“确定”完成动态群组创建。

    图5 群组-创建动态群组
    • 动态规则语法可参考高级搜索
    • 动态群组规则与高级搜索支持字段的不同点:动态群组规则不支持app_id和group_id筛选。
    • 动态规则可以直接单击“预览查询”进行填写,填写完成单击“确定”后自动回写该规则。

动态群组场景示例

通过设备名称模糊匹配规则(其他条件可以根据实际场景选择)创建动态群组,选择该动态群组执行OTA升级任务。

动态群组中的设备会动态根据设备名称匹配情况进行调整,并且该动态群组关联的OTA升级任务详情状态也会随之动态变化。

具体参考批量设备固件升级动态群组的相关步骤进行操作。

  1. 创建动态群组,群组名称为“HuaweiDeviceGroup”,群组规则为 “device_name like 'HuaweiDevice%'”。

    图6 动态群组-详情

  2. 创建设备固件升级任务,选择动态群组“HuaweiDeviceGroup”,完成任务创建。

    图7 新建固件升级任务-动态群组

  3. 创建成功后可以查看动态群组中的设备已加入到该升级任务中。

    图8 固件升级任务-详情(动态群组)

  4. 参考注册单个设备注册设备,设备名称为“HuaweiDevice011”。注册成功后可以查看该设备已自动加入“HuaweiDeviceGroup”动态群组中。

    图9 动态群组-添加设备

  5. 查看软固件升级任务子任务详情,可以看到此设备已自动加入到升级任务中:

    图10 固件升级任务-动态群组添加新设备

  6. 进入“HuaweiDevice001”设备详情界面,修改名称为“AbandonedHuaweiDevice001”。

    图11 设备-设备名称修改

  7. 修改设备名称成功后,可以查看该设备已自动从“HuaweiDeviceGroup”动态群组中移除。

    图12 动态群组-移除设备

  8. 查看软固件升级任务子任务详情,可以看到此设备的升级状态为“已移除”。

    图13 固件升级任务-动态群组移除设备

标签

标签是一种分类方式,您可以在“设备详情”中为设备绑定标签,以便对设备进行灵活的管理。

  1. 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。
  2. 在左侧导航栏选择“设备”,单击“所有设备”,单击设备的“详情”进入设备详情。
  3. 选择“标签”页签,单击“绑定标签”给设备添加标签。

    图14 设备-绑定标签

标签相关API接口

绑定标签

解绑标签