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

修改自定义群组

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

本文介绍修改自定义群组的 API。

接口描述

修改自定义群组，修改群组信息和群组中的设备。

接口地址

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

请求参数

body 说明

参数名	类型	参数位置	是否必填	说明
spaceId	String	body	true	空间 ID
name	String	body	true	群组名称
groupPackageId	String	body	true	自定义群组 ID
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

请求示例

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

{
  "spaceId": "146886924268113****",
  "name": "自定义群组123456",
  "deviceIds": [
    "vdevo16400687183****"
  ],
  "ownerId": "4536****",
  "groupPackageId": "147564952996027****",
  "groupConfigs": "test-update"
}

返回示例

{
    "result": {
        "expiredSeconds": 10,
        "groupPackageId": "147564952996027****",
        "taskId": "147565544970447****"
    },
    "t": 1640658650274,
    "success": true
}

错误码

参考错误码。

上一篇照明自定义群组管理

下一篇创建自定义群组