简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

修改自定义群组

更新时间:2022-09-07 08:38:02下载pdf

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

接口描述

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

接口地址

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

请求参数

body 说明

参数名类型参数位置是否必填说明
spaceIdStringbodytrue空间 ID
nameStringbodytrue群组名称
groupPackageIdStringbodytrue自定义群组 ID
deviceIdsString[]bodytrue需要变更的设备 ID 列表,群组中有的会删除,群组中没有的会添加
ownerIdStringbodyfalse家庭组 ID
groupConfigsStringbodyfalse群组扩展参数

返回参数

参数名类型说明
groupPackageIdString大群组 ID
taskIdString设备状态数量,如果返回 null,不用展示耗时操作,直接完成任务
expiredSecondslong任务过期剩余秒数,如果返回 null,不用展示耗时操作,直接完成任务
groupIdslong[]设备群组 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
}

错误码

参考 错误码