# 云端规则 #### 概述 当用户设置云端规则时，物联网平台会判断是否满足规则触发条件，在条件满足时，平台会执行用户预设的动作。比如：事件告警、主题通知、设备命令下发等。 #### 操作步骤 1. 访问[设备接入服务](https://www.huaweicloud.com/product/iothub.html)，单击"管理控制台"进入设备接入控制台。选择您的实例，单击实例卡片进入。 2. 选择左侧导航栏的"规则 \> 设备联动"，单击页面"创建规则"。 3. 参考下表参数说明，创建设备联动规则。 | 参数名称 | 说明 | 最佳实践 | |:---|:---|:---| | 规则名称 | 创建的规则名称。 | - [温度过高时自动关闭设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0004.html) - [设备触发告警并邮件或短信通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0003.html) - [煤气浓度过高自动打开推窗器](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0021.html) - [监测设备状态变化情况并发送通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0043.html) | | 激活规则 | - 勾选：创建规则后，规则处于激活状态。 - 不勾选：创建规则后，规则处于未激活状态。 | - [温度过高时自动关闭设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0004.html) - [设备触发告警并邮件或短信通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0003.html) - [煤气浓度过高自动打开推窗器](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0021.html) - [监测设备状态变化情况并发送通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0043.html) | | 规则类型 | - 云端规则：创建的规则在云端平台执行。 - 端侧规则：创建的规则下发到端侧执行，需要端侧设备搭载有端侧规则引擎能力的SDK，详见[端侧规则](https://support.huaweicloud.com/usermanual-iothub/iot_01_0041.html)。 | - [温度过高时自动关闭设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0004.html) - [设备触发告警并邮件或短信通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0003.html) - [煤气浓度过高自动打开推窗器](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0021.html) - [监测设备状态变化情况并发送通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0043.html) | | 生效时间 | - 一直生效：没有时间限制，持续检查当前规则条件是否满足。 - 指定时间：可以选择时间段，在特定的时间检查规则条件是否满足。 | - [温度过高时自动关闭设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0004.html) - [设备触发告警并邮件或短信通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0003.html) - [煤气浓度过高自动打开推窗器](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0021.html) - [监测设备状态变化情况并发送通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0043.html) | | 描述 | 对该规则的描述。 | - [温度过高时自动关闭设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0004.html) - [设备触发告警并邮件或短信通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0003.html) - [煤气浓度过高自动打开推窗器](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0021.html) - [监测设备状态变化情况并发送通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0043.html) | | 触发条件 | 满足条件：可设置满足全部条件，或者任意一个条件，触发规则。 - **设备属性触发** ：可以将设备上报的属性作为触发条件，如：温度过高达到80℃，关闭设备。 - 选择产品：选择特定产品。 - 选择设备范围： - 全部设备：对选择产品下的全部设备进行条件设置。 - 指定设备：对选择产品下的指定设备进行条件设置。 - 选择服务：选择产品后选择对应的服务类型。 - 选择属性：选择所需的设备属性作为条件。 说明： - 属性的数据类型为int、long和decimal时，支持选择多种判断符号。 - 属性的数据类型为string，date time，jsonObject时，判断条件仅支持相等。 - 触发机制：选择触发策略类型，建议选择重复抑制。 - 数据时效（秒）：数据有效时间。例如：设备产生数据时间为19:00，时效设为30分钟，平台收到数据时间为20:00，该情况下即使满足触发条件也不触发动作。 - **定时触发** ：可以设置规则触发的时间点，该条件一般用于周期性的触发条件，如每天7:00，关闭路灯。 说明： 当触发条件选择"定时触发"，则动作中不能设置"发送通知"、"上报告警"、"恢复告警"的执行动作。 - 每日定时触发：可选择每日指定时间点触发。 - 按策略定时触发： - 时间点：可以选择规则触发的起始时间点。 - 重复次数：规则重复触发的次数（1\~1440次）。 - 间隔（分钟）：在起始时间点后，重复触发规则的时间间隔（1\~1440分钟）。 - **设备状态触发** ：可以将设备的上下线状态作为触发条件，如：设备离线持续时长达到5分钟，上报告警。 - 选择产品：选择特定产品。 - 选择设备范围： - 全部设备：对选择产品下的全部设备进行条件设置。 - 指定设备：对选择产品下的指定设备进行条件设置。 - 选择触发设备状态： - 上线：设备由离线状态转变为在线状态。 - 下线：设备由在线状态转变为离线状态。 - 上下线：设备状态发生变更。 - 状态持续时长：设备状态发生变更后，新状态的持续时长，单位：分钟，可选0-60分钟。 | - [温度过高时自动关闭设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0004.html) - [设备触发告警并邮件或短信通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0003.html) - [煤气浓度过高自动打开推窗器](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0021.html) - [监测设备状态变化情况并发送通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0043.html) | | 执行动作 | 单击"添加动作"，设置在规则触发后，需要执行的动作。 - **下发命令**：依次选择需要执行下发命令的设备、服务、命令，然后配置下发命令的参数。 - **发送通知** ：选择SMN云服务对应所在区域。如果未授权，根据界面提示配置云服务访问授权，单击相应链接跳转到SMN云服务页面设置主题。 - 消息标题：给邮箱订阅者发送邮件时作为邮件主题。 - 消息类型：可从自定义和使用模板中选择。 - 消息内容：发送的自定义的消息内容。 - 模板选择：使用SMN云服务定义的模板，发送消息时将模板中变量替换成对应的参数值。设备接入定义了一些通用的模板变量，在规则触发后，以下模板变量将会替换成相应的具体值。 {ruleName}：触发的规则名称 {ruleId}：触发的规则ID {deviceId}：触发规则的设备ID {deviceName}：触发规则的设备名称 {productId}：触发规则的设备所属产品的产品ID {productName}：触发规则的设备所属产品的产品名称 {YYYY}：规则触发的年(UTC时间） {MM}：规则触发的月(UTC时间） {DD}：规则触发的日(UTC时间） {HH}：规则触发的时(UTC时间） {mm}：规则触发的分钟(UTC时间） {ss}：规则触发的秒(UTC时间） 说明： 例如，在SMN云服务创建消息模板为以下内容： 时间：{YYYY}-{MM}-{DD} {HH}:{mm}:{ss} 规则名称：{ruleName} 规则Id：{ruleId} 产品Id：{productId} 产品名称：{productName} 设备Id：{deviceId} 设备名称：{deviceName} 事件：设备上下线 则设备上线并触发规则后，收到的消息内容为以下图片所示： ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001743841768.png "点击放大") - **上报告警** ：定义告警级别、告警名称、告警隔离级别和告警内容等。当触发设置的条件后，在[应用运维管理](https://console.huaweicloud.com/aom/#/aom/ams/cloudMonitoring)界面产生一条对应的设备告警。 - 告警级别：可从提示、次要、重要和紧急中选择。 - 告警隔离维度：可从用户、资源空间和设备三个维度中选择，选择不同维度，上报的告警会带上不同的维度标识，如选择设备维度，上报的告警会携带设备ID作为隔离标识。 - 告警名称：上报的告警名称。 - 告警内容：上报的告警需要携带的内容。 - **恢复告警** ：定义告警级别、告警名称、告警隔离级别和告警内容等，参数描述同上报告警参数描述，表示清除设备上报到平台的告警。 说明： 在应用运维管理中，告警级别、告警名称、告警隔离级别组合起来共同标识一条告警，恢复告警时，这三个属性需要和上报告警时保持一致。 | - [温度过高时自动关闭设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0004.html) - [设备触发告警并邮件或短信通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0003.html) - [煤气浓度过高自动打开推窗器](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0021.html) - [监测设备状态变化情况并发送通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0043.html) | 4. 单击右下角"创建规则"，完成设备联动规则的创建。新创建的规则默认状态为"激活"，您可以在规则列表"状态"列，禁用规则。 图1新建联动规则-BatteryProperty ![](https://support.huaweicloud.com/usermanual-iothub/figure/zh-cn_image_0000001950384016.png "点击放大") #### 相关API参考 [查询规则列表](https://support.huaweicloud.com/api-iothub/iot_06_v5_0082.html) [创建规则](https://support.huaweicloud.com/api-iothub/iot_06_v5_0084.html) [查询规则](https://support.huaweicloud.com/api-iothub/iot_06_v5_0087.html) [修改规则](https://support.huaweicloud.com/api-iothub/iot_06_v5_0085.html) [删除规则](https://support.huaweicloud.com/api-iothub/iot_06_v5_0086.html) [修改规则状态](https://support.huaweicloud.com/api-iothub/iot_06_v5_0088.html)