云端规则

概述

当用户设置云端规则时，物联网平台会判断是否满足规则触发条件，在条件满足时，平台会执行用户预设的动作。比如：事件告警、主题通知、设备命令下发等。

操作步骤

1. 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
2. 选择左侧导航栏的“规则 > 设备联动”，单击页面“创建规则”。
3. 参考下表参数说明，创建设备联动规则。

   参数名称	说明	最佳实践
   规则名称	创建的规则名称。	温度过高时自动关闭设备 设备触发告警并邮件或短信通知 煤气浓度过高自动打开推窗器 监测设备状态变化情况并发送通知
   激活规则	勾选：创建规则后，规则处于激活状态。 不勾选：创建规则后，规则处于未激活状态。
   规则类型	云端规则：创建的规则在云端平台执行。 端侧规则：创建的规则下发到端侧执行，需要端侧设备搭载有端侧规则引擎能力的SDK，详见端侧规则。
   生效时间	一直生效：没有时间限制，持续检查当前规则条件是否满足。 指定时间：可以选择时间段，在特定的时间检查规则条件是否满足。
   描述	对该规则的描述。
   触发条件	满足条件：可设置满足全部条件，或者任意一个条件，触发规则。 设备属性触发：可以将设备上报的属性作为触发条件，如：温度过高达到80℃，关闭设备。 选择产品：选择特定产品。 选择设备范围： 全部设备：对选择产品下的全部设备进行条件设置。 指定设备：对选择产品下的指定设备进行条件设置。 选择服务：选择产品后选择对应的服务类型。 选择属性：选择所需的设备属性作为条件。 说明： 属性的数据类型为int、long和decimal时，支持选择多种判断符号。 属性的数据类型为string，date time，jsonObject时，判断条件仅支持相等。 触发机制：选择触发策略类型，建议选择重复抑制。 数据时效（秒）：数据有效时间。例如：设备产生数据时间为19:00，时效设为30分钟，平台收到数据时间为20:00，该情况下即使满足触发条件也不触发动作。 定时触发：可以设置规则触发的时间点，该条件一般用于周期性的触发条件，如每天7:00，关闭路灯。 说明： 当触发条件选择“定时触发”，则动作中不能设置“发送通知”、“上报告警”、“恢复告警”的执行动作。 每日定时触发：可选择每日指定时间点触发。 按策略定时触发： 时间点：可以选择规则触发的起始时间点。 重复次数：规则重复触发的次数（1~1440次）。 间隔（分钟）：在起始时间点后，重复触发规则的时间间隔（1~1440分钟）。 设备状态触发：可以将设备的上下线状态作为触发条件，如：设备离线持续时长达到5分钟，上报告警。 选择产品：选择特定产品。 选择设备范围： 全部设备：对选择产品下的全部设备进行条件设置。 指定设备：对选择产品下的指定设备进行条件设置。 选择触发设备状态： 上线：设备由离线状态转变为在线状态。 下线：设备由在线状态转变为离线状态。 上下线：设备状态发生变更。 状态持续时长：设备状态发生变更后，新状态的持续时长，单位：分钟，可选0-60分钟。
   执行动作	单击“添加动作”，设置在规则触发后，需要执行的动作。 下发命令：依次选择需要执行下发命令的设备、服务、命令，然后配置下发命令的参数。 发送通知：选择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} 事件：设备上下线 则设备上线并触发规则后，收到的消息内容为以下图片所示： 上报告警：定义告警级别、告警名称、告警隔离级别和告警内容等。当触发设置的条件后，在应用运维管理界面产生一条对应的设备告警。 告警级别：可从提示、次要、重要和紧急中选择。 告警隔离维度：可从用户、资源空间和设备三个维度中选择，选择不同维度，上报的告警会带上不同的维度标识，如选择设备维度，上报的告警会携带设备ID作为隔离标识。 告警名称：上报的告警名称。 告警内容：上报的告警需要携带的内容。 恢复告警：定义告警级别、告警名称、告警隔离级别和告警内容等，参数描述同上报告警参数描述，表示清除设备上报到平台的告警。 说明： 在应用运维管理中，告警级别、告警名称、告警隔离级别组合起来共同标识一条告警，恢复告警时，这三个属性需要和上报告警时保持一致。

4. 单击右下角“创建规则”，完成设备联动规则的创建。新创建的规则默认状态为“激活”，您可以在规则列表“状态”列，禁用规则。
   图1 新建联动规则-BatteryProperty
   

相关API参考

查询规则列表

创建规则

查询规则

修改规则

删除规则

修改规则状态