SetDevicesProperty

更新时间:

SetDevicesProperty

调用该接口批量设置设备属性值。

使用说明

物模型功能定义数据类型为float或double时,对应参数值(即使值为整数)至少携带一位小数位。例如10.0、11.1。

请求参数

名称

类型

是否必选

示例值

描述

Action

String

SetDevicesProperty

系统规定参数。取值:SetDevicesProperty。

DeviceName.N

RepeatList

light

要设置属性值的设备名称列表。设备名称的个数范围为1~100个。

Items

String

{"Switch":1,"Color":"blue"}

要设置的属性信息,数据格式为JSON。

每个属性信息由标识符与属性值(key:value)构成,多个属性用英文逗号隔开。

例如,设置智能灯的两个属性:

  • 标识符为Switch的开关属性,数据类型为Bool,设置值为1(开)。

  • 标识符为Color的灯颜色属性,数据类型为String,设置值为blue

那么要设置的属性信息,JSON格式如下:

Items={"Switch":1,"Color":"blue"}

ProductKey

String

a1BwAGV****

要设置属性值的设备所属的产品ProductKey

重要

‼️ 注意:调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数

返回数据

名称

类型

示例值

描述

Code

String

iot.system.SystemException

调用失败时,返回的错误码。更多信息,请参见错误码

ErrorMessage

String

系统异常

调用失败时,返回的出错信息。

RequestId

String

E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

为该请求生成的唯一标识符。

Success

Boolean

true

表示是否调用成功。

  • true:调用成功。

  • false:调用失败。

示例

请求示例

curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=SetDevicesProperty&SignatureNonce=50f8bd97342f4414bdffbce9503b3f9b&AccessKeyId=xMr9wgwXQLhv5AUa65o03mcD&DeviceName.1=myTestDevice&SignatureMethod=HMAC-SHA1&Items=%7B%22rain%22%3A3%7D&Timestamp=2024-11-19T10%3A15%3A23Z&ProductKey=k1ymv1DuLfE&Signature=lp3WdUaJABpJbOK0BnUt7e6PKLI%3D'

正常返回示例

{
  "RequestId": "2E19BDAF-0FD0-4608-9F41-82D230CFEE38",
  "Success": true
}