# 群组和标签 #### 群组概述 群组是一系列设备的集合，用户可以对资源空间下所有设备，根据区域、类型等不同规则进行分类建立群组，以便处理对海量设备的批量操作。例如，对资源空间下所有水表设备的群组进行固件升级。平台支持群组的增删改查操作，支持给群组绑定和解绑设备，支持一个设备被添加到多个群组中。 表1群组分类 | 群组类型 | 使用说明 | |:---|:---| | 静态群组 | 手动添加设备到群组以及从群组中移除设备；支持群组层级嵌套。 **约束限制：** - 账号下单实例最多可创建1,000个群组（包含嵌套的子群组）。 - 一个群组内最多添加20,000个设备。 - 一个设备最多可以被添加到10个群组中。 - 群组嵌套关系最大5级。 - 子群组只能归属一个父群组，不支持多父群组。 - 当群组有子群组时不能直接删除，需要先删除子群组才能删除父群组。 | | 动态群组 | 按照动态群组规则(设备查询条件，类SQL语句)动态的将符合条件的设备自动添加进群组，不符合条件的自动移除群组；不支持手动管理群组中的设备。 **约束限制：** - 账号下单实例最大可创建10个动态群组。 - 首次创建动态群组，规则最多允许匹配的100,000个设备(增量加入群组的设备无限制)。 - 动态群组默认为父群组，不支持将动态群组进行嵌套。 - 动态群组创建成功后，不允许修改动态群组规则。 - 不允许手动管理动态群组中的设备。 - 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 - 单账号创建动态群组的 TPS 限制最大为1/S(每秒1次请求数)。 | #### 管理群组 1. 访问[设备接入服务](https://www.huaweicloud.com/product/iothub.html)，单击"管理控制台"进入设备接入控制台。选择您的实例，单击实例卡片进入。 2. 在左侧导航栏，选择"设备 \> 群组"。 3. 单击相关按钮，进行添加群组、修改群组、删除群组操作。 图1设备-群组 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982639977.png "点击放大") #### 静态群组 1. 访问[设备接入服务](https://www.huaweicloud.com/product/iothub.html)，单击"管理控制台"进入设备接入控制台。选择您的实例，单击实例卡片进入。 2. 在左侧导航栏，选择"设备 \> 群组"。 3. 单击"添加根群组"，进行添加群组，群组类别选择"静态群组"，根据页面提示填写参数，完成后单击"确定"创建群组。 图2群组-创建静态群组 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001950962732.png "点击放大") 4. 可以进入静态群组详情界面对群组下的设备进行绑定和解绑等操作，具体操作见[表2]。 图3静态群组-绑定设备 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982650929.png "点击放大") 表2操作说明 | 操作 | 操作说明 | |:---|:---| | 绑定 | 单击可绑定设备。 | | 批量解绑 | 选中多个设备（一次最多选择100个），单击"批量解绑"按钮，可将选择的设备从当前群组中解绑。 | | 解绑 | 选中设备后，单击"解绑"可将设备从群组中解绑。 | 5. 可以到"设备-\>所有设备"，单击设备的"详情"，再在页面上方单击"群组"，可以查看当前设备加入的群组信息，并进行相关管理操作，具体操作见[表2]。 图4设备-群组管理 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001950973120.png "点击放大") #### 动态群组 1. 访问[设备接入服务](https://www.huaweicloud.com/product/iothub.html)，单击"管理控制台"进入设备接入控制台。选择您的实例，单击实例卡片进入。 2. 在左侧导航栏，选择"设备 \> 群组"。 3. 单击"添加根群组"，进行添加群组，群组类型选择"动态群组"。 4. 根据页面提示填写参数，动态规则输入类SQL语句，单击"配置规则"可查看匹配的设备列表，完成后单击"确定"完成动态群组创建。 图5群组-创建动态群组 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982656353.png "点击放大") ![](https://support.huaweicloud.com/usermanual-iothub/public_sys-resources/note_3.0-zh-cn.png) - 动态规则语法可参考[设备高级搜索](https://support.huaweicloud.com/usermanual-iothub/iot_01_0111.html)。 - 动态群组规则与高级搜索支持字段的不同点：动态群组规则不支持app_id和group_id筛选。 - 动态规则可以直接单击"预览查询"进行填写，填写完成单击"确定"后自动回写该规则。 #### 动态群组场景示例 通过设备名称模糊匹配规则（其他条件可以根据实际场景选择）创建动态群组，选择该动态群组执行OTA升级任务。 动态群组中的设备会动态根据设备名称匹配情况进行调整，并且该动态群组关联的OTA升级任务详情状态也会随之动态变化。 具体参考[批量设备固件升级](https://support.huaweicloud.com/usermanual-iothub/iot_01_01553.html#ZH-CN_TOPIC_0000001875179464__section17111217309)和[动态群组]的相关步骤进行操作。 1. 创建动态群组，群组名称为"HuaweiDeviceGroup"，群组规则为 "device_name like 'HuaweiDevice%'"。 图6动态群组-详情 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982659517.png "点击放大") 2. 创建设备固件升级任务，选择动态群组"HuaweiDeviceGroup"，完成任务创建。 图7新建固件升级任务-动态群组 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001950984890.png "点击放大") 3. 创建成功后可以查看动态群组中的设备已加入到该升级任务中。 图8固件升级任务-详情(动态群组) ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001950986222.png "点击放大") 4. 参考[操作步骤](https://support.huaweicloud.com/usermanual-iothub/iot_01_0031.html#ZH-CN_TOPIC_0000001223635194__section1412615413810)注册设备，设备名称为"HuaweiDevice011"。注册成功后可以查看该设备已自动加入"HuaweiDeviceGroup"动态群组中。 图9动态群组-添加设备 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982790937.png "点击放大") 5. 查看软固件升级任务子任务详情，可以看到此设备已自动加入到升级任务中。 图10固件升级任务-动态群组添加新设备 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982794169.png "点击放大") 6. 进入"HuaweiDevice011"设备详情界面，修改名称为"AbandonedHuaweiDevice001"。 图11设备-设备名称修改 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982804985.png "点击放大") 7. 修改设备名称成功后，可以查看该设备已自动从"HuaweiDeviceGroup"动态群组中移除。 图12动态群组-移除设备 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982805913.png "点击放大") 8. 查看软固件升级任务子任务详情，可以看到此设备的升级状态为"已移除"。 图13固件升级任务-动态群组移除设备 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001951008398.png "点击放大") #### 标签 标签是一种分类方式，您可以在"设备详情"中为设备绑定标签，以便对设备进行灵活的管理。 1. 访问[设备接入服务](https://www.huaweicloud.com/product/iothub.html)，单击"管理控制台"进入设备接入控制台。选择您的实例，单击实例卡片进入。 2. 在左侧导航栏选择"设备"，单击"所有设备"，单击设备的"详情"进入设备详情。 3. 选择"标签"页签，单击"绑定标签"给设备添加标签。 图14设备-绑定标签 ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001982689841.png "点击放大") #### 群组相关API接口 [查询设备组列表](https://support.huaweicloud.com/api-iothub/iot_06_v5_0053.html) [添加设备组](https://support.huaweicloud.com/api-iothub/iot_06_v5_0051.html) [查询设备组](https://support.huaweicloud.com/api-iothub/iot_06_v5_0075.html) [修改设备组](https://support.huaweicloud.com/api-iothub/iot_06_v5_0073.html) [删除设备组](https://support.huaweicloud.com/api-iothub/iot_06_v5_0071.html) [管理设备组中的设备](https://support.huaweicloud.com/api-iothub/iot_06_v5_0070.html) [查询设备组设备列表](https://support.huaweicloud.com/api-iothub/iot_06_v5_0074.html) #### 标签相关API接口 [绑定标签](https://support.huaweicloud.com/api-iothub/iot_06_v5_0009.html) [解绑标签](https://support.huaweicloud.com/api-iothub/iot_06_v5_0010.html)