在物联网平台创建设备分组和子分组，管理分组下设备

物联网平台提供设备分组功能支持跨产品分类设备，您可以将设备按照一定的规则或特性（例如功能、地理位置等）进行划分，以便进行统一管理和控制，提高管理的效率和设备的利用率。本文介绍设备分组应用场景，以及如何创建和管理分组及分组下设备。

应用场景

设备分组可以按照不同的维度进行划分，例如：

功能
将设备按照其功能特性进行分组，例如将所有摄像设备分为一个组，将所有传感器设备分为一个组等。
地理位置
将设备按照其地理位置进行分组，例如将同一地区或者同一建筑物内的设备分为一个组，方便对该地区或者建筑物进行管理和监控。
用途
将设备按照其业务用途进行分组，例如将所有安全设备分为一个组，将所有生产设备分为一个组等。
业务流程
将设备按照其在业务流程中的角色进行分组，例如将所有输入设备分为一个组，将所有输出设备分为一个组等。

设备分组后，可在物联网平台服务中应用：

查询分组管理的设备：可以在物联网控制台或调用云端API，查询不同分组的设备信息。使用方法，请参见下文的查看分组信息和相关API。
数据服务：可以使用设备分组表和设备分组关系表的数据。
- SQL分析：作为SQL分析任务的查询对象，以便进一步利用和分析设备数据。
- 离线数据集成（DataWorks+MaxCompute）：通过大数据开发治理平台DataWorks集成到云原生大数据计算服务MaxCompute中构建数据仓库，以提升数据应用效率。
监控运维：可以按照设备分组维度选择运维的设备。
- OTA升级：创建设备OTA升级批次任务时，可以选择按照设备分组升级。
- 设备任务：创建设备属性设置、服务调用、消息批量下发和自定义任务时，任务对象可以按照设备分组选择。

使用限制

设备分组分为静态和动态两种类型，使用与限制如下。

静态分组

先创建分组，然后在分组中手动添加或移除设备。

静态分组支持添加子分组，支持三级嵌套：父组>一级子分组>二级子分组。
一个阿里云账号下最多可创建1,000个分组，包括所有的分组和子分组。
一个父组最多可包含100个一级子分组。
一个子分组只能属于一个父组。
分组的嵌套关系创建后不能修改，只能删除后重新创建。
分组下有子分组时，不能直接删除分组，需删除全部子分组后，才能删除父组。
支持在分组列表和子分组列表中，进行分组名称模糊搜索。

动态分组

创建分组时配置分组条件规则，动态匹配符合条件的设备到分组，不支持手动添加和移除设备。

当前仅华东2（上海）地域下，企业版实例和新版公共实例，支持创建动态分组。
动态分组默认为父组，且不支持添加子分组。
一个阿里云账号下最多可创建10个动态分组。
首次创建动态分组，配置分组规则后，规则最多允许匹配100,000个设备。分组创建成功后，增量设备数无限制。
动态分组创建成功后，不支持修改动态规则。

创建静态分组

登录物联网平台控制台。
在实例概览页签的全部环境下，找到对应的实例，单击实例卡片。
在左侧导航栏，选择设备管理 > 分组，进入分组页面。

单击创建分组，在弹出对话框中，设置分组参数，并单击确认。

参数	说明
分组类型	选择默认。仅华东2（上海）地域的企业版实例中，显示该参数。
父组	选择父组。单击分组：当前创建的分组是一个父组。单击分组下的某一个分组：以该分组为父组，创建子分组。
分组名称	设置分组名称。分组名称支持中文、英文字母、日文、数字和下划线（_），长度限制为4~30个字符，一个中文或日文占2个字符。重要分组名称必须在账号下唯一，且创建后不能修改。
分组描述	描述该分组信息。

分组创建成功后，您可在分组详情页面，管理设备和子分组。具体操作，请参见下文的管理分组中设备和管理静态分组的子分组。

创建动态分组

在对应实例的左侧导航栏，选择设备管理 > 分组，进入分组页面。
在分组页面，单击创建分组，在弹出的对话框中，按照以下步骤，完成动态分组配置。
1. 选择分组类型为动态。
2. 在动态规则下，输入查询设备的条件规则。
  您可单击预览动态规则，在右侧面板的动态分组条件下，输入查询条件，单击确定。
  分组的查询条件设置方法与设备高级搜索功能相同，详细说明，请参见高级搜索。
  重要
  通过物模型数据搜索设备时，需先配置物模型属性索引，并在一分钟后，再基于该物模型属性创建动态分组来检索设备。
  一个动态分组中最多支持使用100个物模型属性。
  通过设备OTA模块数据搜索设备时，若该动态分组用于设备OTA动态升级，则ota_module.name和ota_module.version必须结合使用。OTA升级更多信息，请参见OTA升级概述。
3. 输入分组名称和分组描述，单击确认。
  分组名称支持中文、英文字母、日文、数字和下划线（_），长度限制为4~30个字符，一个中文或日文占2个字符。
  重要
  分组名称必须在账号下唯一，且创建后不能修改。
动态分组创建成功后，最多一分钟生效。生效后，初始化存量设备最多需要20分钟。动态分组中仅包含符合条件的设备，您可在分组详情页面，查看设备列表。

查看和管理分组

查看分组信息

在对应实例的设备管理 > 分组页面，单击分组列表中目标分组对应操作列的查看。
您可在设备分组详情页面，查看和管理分组信息、分组下设备和子分组。
- 在分组信息页签，可查看当前分组的层级、设备总数、当前在线设备数、激活设备数和分组ID等信息。
  在分组信息页签，可为分组添加标签，即自定义分组标识，以便灵活管理分组。具体内容，请参见分组标签。
- 单击设备列表页签，可查看分组下设备，也可为静态分组添加设备。具体内容，请参见下文的管理分组中设备。
- 单击子分组列页签，可查看分组下子分组，也可为分组添加子分组。具体内容，请参见下文的管理静态分组的子分组。
  说明
  仅静态分组支持此操作。

删除分组

重要

删除静态分组前，必须先删除其中已添加的子分组。

在对应实例的设备管理 > 分组页面，单击分组列表中目标分组对应操作列的删除。
单击确认。

管理分组中设备

添加设备

创建静态分组后，需手动添加分组管理的设备。

在设备管理 > 分组页面的分组列表中，单击分组对应操作列的查看。
在分组详情页面，单击设备列表页签。
单击添加设备到分组，在右侧添加设备到分组面板，选中待添加设备前的复选框，单击确定。
您可根据产品名称或设备名称搜索设备，也可开启列表右上方的高级搜索，搜索设备，还可下载已搜索设备的CSV格式文件。更多信息，请参见高级搜索。
您可单击全部查看所有设备列表，也可单击已选择，查看已选中设备的列表。
重要
- 单次最多添加1,000个设备。
- 单个分组最多添加100,000个设备。
- 一个设备最多可以被添加到10个分组中。

查看设备

在设备列表页签，您可查看全部产品下的所有设备，也可选择某个产品，查看该产品下的所有设备。
您可输入至少5个字符，作为设备名称前缀模糊搜索设备。例如，输入Dtest，可搜索出账号下名称为Dtest1、Dtest2、Dtest3的设备。
单击目标设备对应操作列的查看，可跳转到设备详情页面，查看和管理设备的备注名称、标签、物模型数据和文件等。具体内容，请参见查看设备信息。

移除设备

如果不需要分组管理设备了，可以将设备从分组中移除。

说明

设备从分组中移除，不会从物联网平台删除。

在设备列表页签，找到待移除设备，单击操作列的从分组中移除。
单击确认。

管理静态分组的子分组

子分组功能用于细化设备管理。例如，您可以在“智能家居”分组下，创建“智能厨房”、“智能卧室”等子分组，实现厨房设备和卧室设备的分开管理。

在设备管理 > 分组页面的分组列表中，单击分组对应操作列的查看。
在分组详情页面，单击子分组列表页签。
单击创建分组，选择该子分组的父组，输入子分组名称和描述，然后单击确认。
可选：创建子分组完成后，如果当前子分组是一级子分组，还可参考以上步骤，添加二级子分组。

创建子分组完成后，您可参考上文的查看和管理分组及管理分组中设备，管理子分组、子分组下设备及二级子分组。

API	描述
CreateDeviceGroup	创建静态分组。
CreateDeviceDynamicGroup	创建动态分组。
DeleteDeviceGroup	删除静态分组。
DeleteDeviceDynamicGroup	删除动态分组。
UpdateDeviceGroup	修改分组描述信息和分组类型。
QueryDeviceGroupInfo	查询分组详情：分组名称、分组ID和分组内设备总数、当前在线设备数、激活设备数等。
QueryDeviceGroupList	分页查询分组列表。
QueryDynamicGroupDevices	查询动态分组下的设备列表。
BatchAddDeviceGroupRelations	添加设备到静态分组。
BatchDeleteDeviceGroupRelations	删除分组中已添加的指定设备。
SetDeviceGroupTags	添加或更新分组标签。
QueryDeviceGroupTagList	查询分组标签列表。
QueryDeviceGroupByDevice	查询指定设备所在的分组列表。
QuerySuperDeviceGroup	根据子分组ID查询父分组信息。
QueryDeviceListByDeviceGroup	查询分组中的设备列表。
QueryDeviceGroupByTags	根据标签查询设备分组。