修改规则 - UpdateRule

project_id

是

String

参数说明：项目ID。获取方法请参见 获取项目ID。

rule_id

是

String

参数说明：规则ID，用于唯一标识一条规则，在创建规则时由物联网平台分配获得。

取值范围：长度不超过32，只允许字母、数字的组合。

Instance-Id

否

String

参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考 查看实例详情。

name

是

String

参数说明：规则名称。

description

否

String

参数说明：规则的描述信息。

condition_group

是

ConditionGroup object

参数说明：规则的条件组，包含简单规则和复杂规则集合。

actions

是

Array of RuleAction objects

参数说明：规则的动作列表，单个规则最多支持设置10个动作。

rule_type

是

String

参数说明：规则的类型。

取值范围：

• DEVICE_LINKAGE：云端联动规则。

• DEVICE_SIDE：端侧规则。

status

否

String

参数说明：规则的状态，默认值：active。

取值范围：

• active：激活。

• inactive：未激活。

app_id

否

String

参数说明：资源空间ID。此参数为非必选参数，存在多资源空间的用户需要使用该接口时，建议携带该参数指定创建的规则归属到哪个资源空间下，否则创建的规则将会归属到默认资源空间下。

取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。

device_side

否

DeviceSide object

参数说明：端侧执行下发设备信息，当规则类型为DEVICE_SIDE时，该参数必填。

conditions

否

Array of RuleCondition objects

参数说明：规则的条件列表，单个规则最多支持设置10个条件。

logic

否

String

参数说明：规则条件列表中多个条件之间的逻辑关系，默认值：and。

取值范围：

• and：逻辑且。

• or：逻辑或。

time_range

否

TimeRange object

参数说明：规则条件触发的有效时间段。

type

是

String

参数说明：规则条件的类型。

取值范围：

• DEVICE_DATA：设备属性数据类型条件。

• SIMPLE_TIMER：简单定时类型条件。

• DAILY_TIMER：每日定时类型条件。

• DEVICE_LINKAGE_STATUS：设备状态类型条件。

device_property_condition

否

DeviceDataCondition object

参数说明：条件中设备数据类型的信息，当type为DEVICE_DATA时，为必选参数。

simple_timer_condition

否

SimpleTimerType object

参数说明：条件中简单定时类型的信息，当type为SIMPLE_TIMER时，为必选参数。

daily_timer_condition

否

DailyTimerType object

参数说明：条件中每日定时类型的信息，当type为DAILY_TIMER时，为必选参数。

device_linkage_status_condition

否

DeviceLinkageStatusCondition object

参数说明：条件中设备状态类型的信息，当规则类型为DEVICE_LINKAGE且type为DEVICE_LINKAGE_STATUS时，为必选参数。

device_id

否

String

参数说明：设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。存在该参数时设备属性触发根据指定设备触发，该参数值和product_id不能同时为空。如果该参数和product_id同时存在时，以该参数值对应的设备进行条件过滤。

取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

product_id

否

String

参数说明：设备关联的产品ID，用于唯一标识一个产品模型，创建产品后获得。方法请参见 创建产品。存在该参数且device_id为空时设备属性触发匹配该产品下所有设备触发，该参数值和device_id不能同时为空。

filters

否

Array of PropertyFilter objects

数据过滤条件。

path

是

String

参数说明：设备属性的路径信息，格式：service_id/DataProperty，例如门磁状态为“DoorWindow/status”。

operator

是

String

参数说明：数据比较的操作符。

取值范围：当前支持的操作符有：>，<，>=，<=，=，in:表示在指定值中匹配和between:表示数值区间。

value

否

String

参数说明：数据比较表达式的右值。与数据比较操作符between联用时，右值表示最小值和最大值，用逗号隔开，如“20,30”表示大于等于20小于30。

in_values

否

Array of strings

参数说明：当operator为in时该字段必填，使用该字段传递比较表达式右值，上限为20个。

strategy

否

Strategy object

参数说明：规则条件的处理策略，用于确定规则是否判断上次数据是否满足条件。当rule_type为DEVICE_LINKAGE时，该参数值不能为空。端侧执行不支持该字段。

trigger

否

String

参数说明：规则条件触发的判断策略，默认为pulse。

取值范围：

• pulse：设备上报的数据满足条件则触发，不判断上一次上报的数据。

• reverse：设备上一次上报的数据不满足条件，本次上报的数据满足条件则触发。

event_valid_time

否

Integer

参数说明：设备数据的有效时间，单位为秒，设备数据的产生时间以上报数据中的eventTime为基准。

start_time

是

String

参数说明：规则触发的开始时间，使用UTC时区，格式：yyyyMMdd'T'HHmmss'Z'。

repeat_interval

是

Integer

参数说明：规则触发的重复时间间隔，单位为秒。

repeat_count

是

Integer

参数说明：规则触发的重复次数。

time

是

String

参数说明：规则触发的时间，格式：HH:MM。

days_of_week

否

String

参数说明：星期列表，以逗号分隔。1代表周日，2代表周一，依次类推，默认为每天。

device_id

否

String

参数说明：设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。存在该参数时设备状态触发根据指定设备触发，该参数值和product_id不能同时为空。如果该参数和product_id同时存在时，以该参数值对应的设备进行条件过滤。

取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

product_id

否

String

参数说明：设备关联的产品ID，用于唯一标识一个产品模型，创建产品后获得。方法请参见 创建产品。存在该参数且device_id为空时设备状态触发匹配该产品下所有设备触发，该参数值和device_id不能同时为空。

status_list

否

Array of strings

参数说明：状态列表，设备状态条件携带该参数。

取值范围：

• ONLINE：设备上线

• OFFLINE：设备下线

duration

否

Integer

持续时长：设备状态持续时长，取值范围: 0-60(分钟)。

start_time

是

String

参数说明：规则条件触发的开始时间，格式：HH:mm。

end_time

是

String

参数说明：规则条件触发的结束时间，格式：HH:mm。若结束时间与开始时间一致，则时间为全天。

days_of_week

否

String

参数说明：星期列表，以逗号分隔。1代表周日，2代表周一，依次类推，默认为每天。星期列表中的日期为开始时间的日期。

type

是

String

参数说明：规则动作的类型，端侧执行只支持下发设备命令消息类型。

取值范围：

• DEVICE_CMD：下发设备命令消息类型。

• SMN_FORWARDING：发送SMN消息类型。

• DEVICE_ALARM：上报设备告警消息类型。当选择该类型时，condition中必须有DEVICE_DATA条件类型。该类型动作只能唯一。

device_command

否

ActionDeviceCommand object

下发设备命令消息内容。当type为DEVICE_CMD时，必填。

smn_forwarding

否

ActionSmnForwarding object

发送给SMN消息结构。当规则类型为DEVICE_LINKAGE且type为SMN_FORWARDING时，必填。

device_alarm

否

ActionDeviceAlarm object

上报设备告警消息内容。当规则类型为DEVICE_LINKAGE且type为DEVICE_ALARM时，必填。

device_id

否

String

参数说明：下发命令的设备ID。

• 当创建设备数据规则时，若device_id为空，则命令下发给触发条件的设备。

• 当创建定时规则时，不允许为空。

取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

cmd

是

CMD object

参数说明：下发的命令信息。

command_name

是

String

参数说明：设备命令名称，在设备关联的产品模型中定义。

command_body

是

Object

参数说明：设备命令参数，Json格式。

使用LWM2M协议设备命令示例：{"value":"1"}，里面是一个个键值对，每个键都是产品模型中命令的参数名（paraName）。

使用MQTT协议设备命令示例：{"header": {"mode": "ACK","from": "/users/testUser","method": "SET_TEMPERATURE_READ_PERIOD","to":"/devices/{device_id}/services/{service_id}"},"body": {"value" : "1"}}。

• mode：必选，设备收到命令后是否需要回复确认消息，默认为ACK模式。ACK表示需要回复确认消息，NOACK表示不需要回复确认消息，其它值无效。

• from：可选，命令发送方的地址。App发起请求时格式为/users/{userId} ，应用服务器发起请求时格式为/{serviceName}，物联网平台发起请求时格式为/cloud/{serviceName}。

• to：可选，命令接收方的地址，格式为/devices/{device_id}/services/{service_id}。

• method：可选，产品模型中定义的命令名称。

• body：可选，命令的消息体，里面是一个个键值对，每个键都是产品模型中命令的参数名（paraName）。具体格式需要应用和设备约定。

service_id

是

String

参数说明：设备命令所属的设备服务ID，在设备关联的产品模型中定义。

buffer_timeout

否

Integer

参数说明：设备命令的缓存时间，单位为秒，表示物联网平台在把命令下发给设备前缓存命令的有效时间，超过这个时间后命令将不再下发，默认值为172800s（48小时）。

如果buffer_timeout设置为0，则无论物联网平台上设置的命令下发模式是什么，该命令都会立即下发给设备。

response_timeout

否

Integer

参数说明：命令响应的有效时间，单位为秒，表示设备接收到命令后，在response_timeout时间内响应有效，超过这个时间未收到命令的响应，则认为命令响应超时，默认值为1800s。

mode

否

String

参数说明：设备命令的下发模式，仅当buffer_timeout的值大于0时有效。

• ACTIVE：主动模式，物联网平台主动将命令下发给设备。

• PASSIVE：被动模式，物联网平台创建设备命令后，会直接缓存命令。等到设备再次上线或者上报上一条命令的执行结果后才下发命令。

region_name

是

String

参数说明：SMN服务对应的region区域。

project_id

是

String

参数说明：SMN服务对应的projectId信息。

theme_name

是

String

参数说明：SMN服务对应的主题名称。

topic_urn

是

String

参数说明：SMN服务对应的topic的主题URN。

message_content

否

String

参数说明：短信或邮件的内容。

message_template_name

否

String

参数说明：SMN服务对应的模板名称。

message_title

是

String

参数说明：短信或邮件的主题。最大长度支持UTF-8编码后的521个字节。

name

是

String

参数说明：告警名称。

alarm_status

是

String

参数说明：告警状态。

取值范围：

• fault：上报告警。

• recovery：恢复告警。

severity

是

String

参数说明：告警级别。

取值范围：warning（警告）、minor（一般）、major（严重）和critical（致命）。

dimension

否

String

参数说明：告警维度，与告警名称和告警级别组合起来共同标识一条告警，默认不携带该字段为用户维度告警，支持设备维度和资源空间维度告警。

取值范围：

• device：设备维度。

• app：资源空间维度。

description

否

String

参数说明：告警的描述信息。

device_ids

否

Array of strings

参数说明：端侧执行下发的目标设备ID列表。设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。

rule_id

String

规则id。

name

String

规则名称。

description

String

规则的描述信息。

condition_group

ConditionGroup object

规则的条件组，包含简单规则和复杂规则集合。

actions

Array of RuleAction objects

规则的动作列表，单个规则最多支持设置10个动作。

rule_type

String

规则的类型

• DEVICE_LINKAGE：云端联动规则。

• DEVICE_SIDE：端侧规则。

status

String

规则的状态，默认值：active。

• active：激活。

• inactive：未激活。

app_id

String

资源空间ID。此参数为非必选参数，存在多资源空间的用户需要使用该接口时，建议携带该参数指定创建的规则归属到哪个资源空间下，否则创建的规则将会归属到默认资源空间下。

edge_node_ids

Array of strings

归属边缘侧节点设备ID列表。

last_update_time

String

规则最后更新时间，使用UTC时区，格式：yyyyMMdd'T'HHmmss'Z'。

device_side

DeviceSide object

参数说明：端侧执行下发设备信息，当规则类型为DEVICE_SIDE时，该参数必填。

conditions

Array of RuleCondition objects

参数说明：规则的条件列表，单个规则最多支持设置10个条件。

logic

String

参数说明：规则条件列表中多个条件之间的逻辑关系，默认值：and。

取值范围：

• and：逻辑且。

• or：逻辑或。

time_range

TimeRange object

参数说明：规则条件触发的有效时间段。

type

String

参数说明：规则条件的类型。

取值范围：

• DEVICE_DATA：设备属性数据类型条件。

• SIMPLE_TIMER：简单定时类型条件。

• DAILY_TIMER：每日定时类型条件。

• DEVICE_LINKAGE_STATUS：设备状态类型条件。

device_property_condition

DeviceDataCondition object

参数说明：条件中设备数据类型的信息，当type为DEVICE_DATA时，为必选参数。

simple_timer_condition

SimpleTimerType object

参数说明：条件中简单定时类型的信息，当type为SIMPLE_TIMER时，为必选参数。

daily_timer_condition

DailyTimerType object

参数说明：条件中每日定时类型的信息，当type为DAILY_TIMER时，为必选参数。

device_linkage_status_condition

DeviceLinkageStatusCondition object

参数说明：条件中设备状态类型的信息，当规则类型为DEVICE_LINKAGE且type为DEVICE_LINKAGE_STATUS时，为必选参数。

device_id

String

参数说明：设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。存在该参数时设备属性触发根据指定设备触发，该参数值和product_id不能同时为空。如果该参数和product_id同时存在时，以该参数值对应的设备进行条件过滤。

取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

product_id

String

参数说明：设备关联的产品ID，用于唯一标识一个产品模型，创建产品后获得。方法请参见 创建产品。存在该参数且device_id为空时设备属性触发匹配该产品下所有设备触发，该参数值和device_id不能同时为空。

filters

Array of PropertyFilter objects

数据过滤条件。

path

String

参数说明：设备属性的路径信息，格式：service_id/DataProperty，例如门磁状态为“DoorWindow/status”。

operator

String

参数说明：数据比较的操作符。

取值范围：当前支持的操作符有：>，<，>=，<=，=，in:表示在指定值中匹配和between:表示数值区间。

value

String

参数说明：数据比较表达式的右值。与数据比较操作符between联用时，右值表示最小值和最大值，用逗号隔开，如“20,30”表示大于等于20小于30。

in_values

Array of strings

参数说明：当operator为in时该字段必填，使用该字段传递比较表达式右值，上限为20个。

strategy

Strategy object

参数说明：规则条件的处理策略，用于确定规则是否判断上次数据是否满足条件。当rule_type为DEVICE_LINKAGE时，该参数值不能为空。端侧执行不支持该字段。

trigger

String

参数说明：规则条件触发的判断策略，默认为pulse。

取值范围：

• pulse：设备上报的数据满足条件则触发，不判断上一次上报的数据。

• reverse：设备上一次上报的数据不满足条件，本次上报的数据满足条件则触发。

event_valid_time

Integer

参数说明：设备数据的有效时间，单位为秒，设备数据的产生时间以上报数据中的eventTime为基准。

start_time

String

参数说明：规则触发的开始时间，使用UTC时区，格式：yyyyMMdd'T'HHmmss'Z'。

repeat_interval

Integer

参数说明：规则触发的重复时间间隔，单位为秒。

repeat_count

Integer

参数说明：规则触发的重复次数。

time

String

参数说明：规则触发的时间，格式：HH:MM。

days_of_week

String

参数说明：星期列表，以逗号分隔。1代表周日，2代表周一，依次类推，默认为每天。

device_id

String

参数说明：设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。存在该参数时设备状态触发根据指定设备触发，该参数值和product_id不能同时为空。如果该参数和product_id同时存在时，以该参数值对应的设备进行条件过滤。

取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

product_id

String

参数说明：设备关联的产品ID，用于唯一标识一个产品模型，创建产品后获得。方法请参见 创建产品。存在该参数且device_id为空时设备状态触发匹配该产品下所有设备触发，该参数值和device_id不能同时为空。

status_list

Array of strings

参数说明：状态列表，设备状态条件携带该参数。

取值范围：

• ONLINE：设备上线

• OFFLINE：设备下线

duration

Integer

持续时长：设备状态持续时长，取值范围: 0-60(分钟)。

start_time

String

参数说明：规则条件触发的开始时间，格式：HH:mm。

end_time

String

参数说明：规则条件触发的结束时间，格式：HH:mm。若结束时间与开始时间一致，则时间为全天。

days_of_week

String

参数说明：星期列表，以逗号分隔。1代表周日，2代表周一，依次类推，默认为每天。星期列表中的日期为开始时间的日期。

type

String

参数说明：规则动作的类型，端侧执行只支持下发设备命令消息类型。

取值范围：

• DEVICE_CMD：下发设备命令消息类型。

• SMN_FORWARDING：发送SMN消息类型。

• DEVICE_ALARM：上报设备告警消息类型。当选择该类型时，condition中必须有DEVICE_DATA条件类型。该类型动作只能唯一。

device_command

ActionDeviceCommand object

下发设备命令消息内容。当type为DEVICE_CMD时，必填。

smn_forwarding

ActionSmnForwarding object

发送给SMN消息结构。当规则类型为DEVICE_LINKAGE且type为SMN_FORWARDING时，必填。

device_alarm

ActionDeviceAlarm object

上报设备告警消息内容。当规则类型为DEVICE_LINKAGE且type为DEVICE_ALARM时，必填。

device_id

String

参数说明：下发命令的设备ID。

• 当创建设备数据规则时，若device_id为空，则命令下发给触发条件的设备。

• 当创建定时规则时，不允许为空。

取值范围：长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。

cmd

CMD object

参数说明：下发的命令信息。

command_name

String

参数说明：设备命令名称，在设备关联的产品模型中定义。

command_body

Object

参数说明：设备命令参数，Json格式。

使用LWM2M协议设备命令示例：{"value":"1"}，里面是一个个键值对，每个键都是产品模型中命令的参数名（paraName）。

使用MQTT协议设备命令示例：{"header": {"mode": "ACK","from": "/users/testUser","method": "SET_TEMPERATURE_READ_PERIOD","to":"/devices/{device_id}/services/{service_id}"},"body": {"value" : "1"}}。

• mode：必选，设备收到命令后是否需要回复确认消息，默认为ACK模式。ACK表示需要回复确认消息，NOACK表示不需要回复确认消息，其它值无效。

• from：可选，命令发送方的地址。App发起请求时格式为/users/{userId} ，应用服务器发起请求时格式为/{serviceName}，物联网平台发起请求时格式为/cloud/{serviceName}。

• to：可选，命令接收方的地址，格式为/devices/{device_id}/services/{service_id}。

• method：可选，产品模型中定义的命令名称。

• body：可选，命令的消息体，里面是一个个键值对，每个键都是产品模型中命令的参数名（paraName）。具体格式需要应用和设备约定。

service_id

String

参数说明：设备命令所属的设备服务ID，在设备关联的产品模型中定义。

buffer_timeout

Integer

参数说明：设备命令的缓存时间，单位为秒，表示物联网平台在把命令下发给设备前缓存命令的有效时间，超过这个时间后命令将不再下发，默认值为172800s（48小时）。

如果buffer_timeout设置为0，则无论物联网平台上设置的命令下发模式是什么，该命令都会立即下发给设备。

response_timeout

Integer

参数说明：命令响应的有效时间，单位为秒，表示设备接收到命令后，在response_timeout时间内响应有效，超过这个时间未收到命令的响应，则认为命令响应超时，默认值为1800s。

mode

String

参数说明：设备命令的下发模式，仅当buffer_timeout的值大于0时有效。

• ACTIVE：主动模式，物联网平台主动将命令下发给设备。

• PASSIVE：被动模式，物联网平台创建设备命令后，会直接缓存命令。等到设备再次上线或者上报上一条命令的执行结果后才下发命令。

region_name

String

参数说明：SMN服务对应的region区域。

project_id

String

参数说明：SMN服务对应的projectId信息。

theme_name

String

参数说明：SMN服务对应的主题名称。

topic_urn

String

参数说明：SMN服务对应的topic的主题URN。

message_content

String

参数说明：短信或邮件的内容。

message_template_name

String

参数说明：SMN服务对应的模板名称。

message_title

String

参数说明：短信或邮件的主题。最大长度支持UTF-8编码后的521个字节。

name

String

参数说明：告警名称。

alarm_status

String

参数说明：告警状态。

取值范围：

• fault：上报告警。

• recovery：恢复告警。

severity

String

参数说明：告警级别。

取值范围：warning（警告）、minor（一般）、major（严重）和critical（致命）。

dimension

String

参数说明：告警维度，与告警名称和告警级别组合起来共同标识一条告警，默认不携带该字段为用户维度告警，支持设备维度和资源空间维度告警。

取值范围：

• device：设备维度。

• app：资源空间维度。

description

String

参数说明：告警的描述信息。

device_ids

Array of strings

参数说明：端侧执行下发的目标设备ID列表。设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error