修改联动规则

本文介绍修改联动规则的 API。

接口描述

修改联动规则。

接口地址

PUT: /v2.0/cloud/scene/rule/{rule_id}

请求参数

参数名	类型	参数位置	是否必填	说明
rule_id	String	uri	true	联动规则 ID。

body 说明

参数名	类型	参数位置	是否必填	说明
space_id	String		true	联动关联空间 ID。
name	String		false	联动规则的名称。
decision_expr	String		false	条件表达式。 and：且。 or：或。 c1&c2：自定义表达式。
conditions	List		false	条件集合。
actions	List		false	动作集合。
effective_time	EffectiveTime		false	生效时间。

effective_time 说明

参数名	类型	参数位置	是否必填	说明
start	String		true	开始时间。
end	String		true	结束时间。
loops	String		true	联动规则触发周期，由 0 和 1 组成的 7 位数字。0 表示不执行，1 表示执行。第 1 位为周日，依次表示周一至周六。例如，0011000 表示每周二和周三执行。
time_zone_id	String		true	时区 ID。

conditions 说明

参数名	类型	参数位置	是否必填	说明
entity_id	String		true	条件对象 ID。
entity_type	String		true	条件对象类型。 timer：定时。 weather：天气条件。 device_report：设备上报。
code	Integer		true	条件编码，不可重复。
expr	Expr		true	计算表达式。

actions 说明

参数名	类型	参数位置	是否必填	说明
entity_id	String		true	动作对象 ID。
action_executor	String		true	动作对象类型。 delay：延时。 device_issue：设备指令下发。 device_group_issue：群组指令下发。
executor_property	ExecutorProperty		true	动作明细。

expr 说明

参数名	类型	参数位置	是否必填	说明
status_code	String		true	状态集 code。当 entity_type 是 device_report 时，此参数必填。
comparator	String		true	比较表达式。当 entity_type 是 device_report 和 weather 时，此参数必填。 ==：等于。 >：大于。 <：小于。
status_value	Object		true	状态集 value。当 entity_type 是 device_report 时，此参数必填。
date	String		false	联动规则触发日期。
time	String		true	联动规则触发时间。
loops	String		false	联动规则触发周期，由 0 和 1 组成的 7 位数字。0 表示不执行，1 表示执行。第 1 位为周日，依次表示周一至周六。例如，0011000 表示每周二和周三执行。
time_zone_id	String		true	时区 ID。
weather_code	String		true	状态集 code。当 entity_type 是 weather 时，此参数必填。
weather_value	Object		true	状态集 value。当 entity_type 是 weather 时，此参数必填。

executor_property 说明

参数名	类型	参数位置	是否必填	说明
function_code	String		true	指令 code。当 action_executor 是 device_issue 或 device_group_issue 时，此参数必填。
function_value	Object		true	指令 value。当 action_executor 是 device_issue 或 device_group_issue 时，此参数必填。
delay_seconds	Integer		true	延时时间。当 action_executor 是 delay 时，此参数必填。

返回参数

参数名	类型	说明
result	Boolean	联动规则修改是否成功。

请求示例

PUT: /v2.0/cloud/scene/rule/***

{
  "space_id": "150***",
  "name": "测试场景",
  "type": "automation",
  "decision_expr": "or",
  "effective_time": {
    "start": "00:00",
    "end": "23:00",
    "loops": "1111111",
    "timezone_id": "Asia/Shanghai"
  },
  "conditions": [
    {
      "code": 1,
      "entity_id": "****",
      "entity_type": "device_report",
      "expr": {
        "status_code": "switch_1",
        "comparator": "==",
        "status_value": true
      }
    }
  ],
  "actions": [
    {
      "entity_id": "****",
      "action_executor": "device_issue",
      "executor_property": {
        "function_code": "switch_1",
        "function_value": true
      }
    }
  ]
}

返回示例

{
    "tid": "****",
    "result": true,
    "t": 1677741828415,
    "success": true
}

错误码

参考 错误码。

调用频率限制

参考 调用频率限制。