更新时间：2024-10-22 GMT+08:00
云端规则
概述
当用户设置云端规则时，物联网平台会判断是否满足规则触发条件，在条件满足时，平台会执行用户预设的动作。比如：事件告警、主题通知、设备命令下发等。
操作步骤
- 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
- 选择左侧导航栏的，单击页面“创建规则”。
- 参考下表参数说明，创建设备联动规则。
参数名称
说明
最佳实践
规则名称
创建的规则名称。
激活规则
- 勾选：创建规则后，规则处于激活状态。
规则类型
- 云端规则：创建的规则在云端平台执行。
- 端侧规则：创建的规则下发到端侧执行，需要端侧设备搭载有端侧规则引擎能力的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云服务定义的模板，发送消息时将模板中变量替换成对应的参数值。设备接入定义了一些通用的模板变量，在规则触发后，以下模板变量将会替换成相应的具体值。
{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作为隔离标识。
- 告警名称：上报的告警名称。
- 告警内容：上报的告警需要携带的内容。
- 恢复告警：定义告警级别、告警名称、告警隔离级别和告警内容等，参数描述同上报告警参数描述，表示清除设备上报到平台的告警。
说明：
在应用运维管理中，告警级别、告警名称、告警隔离级别组合起来共同标识一条告警，恢复告警时，这三个属性需要和上报告警时保持一致。
- 单击右下角“创建规则”，完成设备联动规则的创建。新创建的规则默认状态为“激活”，您可以在规则列表“状态”列，禁用规则。
图1 新建联动规则-BatteryProperty
父主题： 设备联动
