更新设备群组

更新时间：2023-07-06 07:55:04下载pdf

本文介绍更新设备群组的 API。

接口描述

通过设备群组 ID 更新群组信息。当设备群组中的设备没有变动时，返回信息无任务 ID 和过期时间。当设备群组中的设备发生变动时，需通过任务 ID 使用查询群组任务信息接口查看任务是否成功。

接口地址

PUT: /v1.0/iot-03/device-groups/{group_id}

请求参数

参数名	类型	参数位置	是否必填	说明
group_id	String	uri	true	群组 ID

body 说明

参数名	类型	是否必填	说明
group_name	String	false	群组名称
asset_id	String	false	资产 ID
device_ids	List	false	设备 ID

返回参数

参数名	类型	说明
result	GroupPackageTaskVO	更新群组的任务信息

result 说明

参数名	类型	说明
group_id	String	群组 ID
task_id	String	任务 ID，当设备没有变动时，无任务 ID
expire_time	Long	过期时间，单位秒，当设备没有变动时无过期时间

请求示例

PUT: /v1.0/iot-03/device-groups/1405519276818854****

{
  "group_name": "照明",
  "asset_id": "145248249804602****",
  "device_ids": [
    "6c9a276l739687ul3****",
    "6c6a8s608j21n78f1****"
  ]
}

返回示例

{
    "result": {
        "expire_time": 14,
        "task_id": "1405519276103219****",
        "group_id": "1405519276818854****"
    },
    "t": 1623938320521,
    "success": true
}

错误码

参考错误码。