云服务 API 参考行业场景垂直行业解决方案校园办公照明管理照明设备管理创建设备群组

创建设备群组

更新时间：2023-07-06 07:53:51下载pdf

本文介绍创建设备群组的 API。

接口描述

通过设备 ID 集和群组名称创建设备群组。创建完成后，需通过任务 ID 使用查询群组任务信息接口查看任务是否成功。

接口地址

POST: /v1.0/iot-03/device-groups

请求参数

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
expire_time	Long	过期时间，单位秒

请求示例

POST:  /v1.0/iot-03/device-groups

{
  "group_name": "bulu-13n-test",
  "asset_id": "145248249804602****",
  "device_ids": [
    "6c9680b7****"
  ]
}

返回示例

{
    "result": {
        "expired_seconds": 10,
        "task_id": "14057567104****",
        "group_id": "140511714560****"
    },
    "t": 1623846099825,
    "success": true
}

错误码

参考错误码。

上一篇新增场景联动