批量修改设备快照信息 - 根据标签
此接口用于根据标签批量修改设备的快照信息。
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"
}