批量修改设备快照信息 - 根据标签
此接口用于根据标签批量修改设备的快照信息。
1 接口路径
POST /api/v1/device/attributes/batch/tag
2 请求参数
body参数,json格式:
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
productKey | String | 是 | 产品唯一标识 |
tags | Object | 是 | 设备标签tag,json对象 |
desired | Object | 是 | 期望值,json对象 |
liveTime | Integer | 否 | 消息缓存时长(单位秒),0为不缓存,最大值604800(7天),默认值604800 |
version | String | 否 | 协议版本 |
3 返回参数
统一返回参数说明参考:公共参数,正常的返回业务参数(data
)为null
。
4 返回状态码
公共状态码说明参考:公共参数,以下是业务关联的状态码说明:
code | 描述 |
---|---|
120105 | 设备属性期望值不能为空 |
5 示例
请求示例
{
"serviceKey": "service_down_async",
"desired": {
"color":"1234"
},
"tags": {
"room": "001"
},
"version": "1.0.0",
"liveTime": 60,
"productKey": "e4ceb4e874e"
}
返回示例
{
"code": "000000",
"data": null,
"message": "success"
}