Call this operation to set properties for multiple devices.

Limits

The maximum number of requests per second for a tenant is 10 QPS.

Request parameters

Parameter Type Required Description
Action String Yes The operation that you want to perform. Set the value to SetDeviceProperty.
ProductKey String Yes

The ProductKey of the specified devices.

DeviceNames List<String> Yes

List of devices for which you want to set properties. Currently, up to 100 devices are supported.

Items String Yes

The properties to be set. The value of this parameter is a JSON string with key-value pairs (key: value).

If the arguments are not specified, you must pass in this parameter as Items={}.

For more information about Items, see the following table Items.

Common request parameters - Yes See Common parameters.
Table 1. Items
Parameter Type Description
Key String

The identifier of the property that you have set. To view the property identifier of the devices, go to the Define Feature page of the product to which the devices belongs in the console.

Note You must specify a read-write property. If you specify a read-only property, the setting fails.
value Object The property value. The value must match the data type and fall in the range that you have set for the property.

Response parameters

Parameter Type Description
RequestId String The globally unique ID generated by Alibaba Cloud for the request.
Success Boolean Indicates whether the call is successful. A value of true indicates that the call is successful. A value of false indicates that the call has failed.
ErrorMessage String The error message returned when the call fails.
Code String The error code returned when the call fails. For more information about error codes, see Error codes.

Examples

Request example

https://iot.cn-shanghai.aliyuncs.com/&Action=SetDevicesProperty
&DeviceName. 1=1102andriod02
&DeviceName. 2=1102android01
&Items=%7B%20%20%20%20%20%22Data%22%3A%221372060916%22%2C%20%20%20%20%20%22Status%22%3A1%20%7D
&ProductKey=a1hWjHDWUbF
&Common request parameters

Response example

JSON format

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

XML format

<? xml version='1.0' encoding='utf-8'? >
<SetDevicesPropertyResponse>
    <RequestId>"2E19BDAF-0FD0-4608-9F41-82D230CFEE3</RequestId>
    <Success>true</Success>
</SetDevicesPropertyResponse>