云服务 API 参考行业场景垂直行业解决方案商用照明 SaaS 基础服务照明自定义群组管理创建自定义群组

创建自定义群组

更新时间：2023-06-21 07:12:57下载pdf

本文介绍创建自定义群组的 API。

接口描述

创建自定义群组，默认归属到空间所在家庭组。

接口地址

POST: /v1.0/iot-02/lighting/groups/package

请求参数

body 说明

参数名	类型	参数位置	是否必填	说明
spaceId	String	body	true	空间 ID
name	String	body	true	群组名称
deviceIds	String[]	body	true	设备 ID 列表
ownerId	String	body	false	家庭组 ID
groupConfigs	String	body	false	群组扩展参数

返回参数

参数名	类型	说明
groupPackageId	String	大群组 ID
taskId	String	设备状态数量，如果返回 null，不用展示耗时操作，直接完成任务
expiredSeconds	long	任务过期剩余秒数，如果返回 null，不用展示耗时操作，直接完成任务
groupIds	long[]	设备群组 ID 列表

请求示例

POST: /v1.0/iot-02/lighting/groups/package

{
  "spaceId": "146886924268113****",
  "name": "自定义群组123467",
  "deviceIds": [
    "vdevo16393774893****",
    "vdevo16393775054****"
  ],
  "ownerId": "45360622",
  "groupConfigs": "test"
}

返回示例

{
    "result": {
        "groupIds": [
            12089569,
            12089570
        ],
        "expiredSeconds": 14,
        "groupPackageId": "147566148209509****",
        "taskId": "147566148214961****"
    },
    "t": 1640660088966,
    "success": true
}

错误码

参考错误码。

上一篇修改自定义群组

下一篇删除自定义群组