创建设备群组

更新时间：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
}

错误码

参考错误码。

上一篇新增场景联动