设备群组移除设备

更新时间:2023-06-15 05:04:05

本文介绍设备群组移除设备的 API。

接口描述

从设备群组中移除设备,为了提高移除效率,单次移除限制为 20 个。

接口地址

POST: /v1.0/iot-03/device-groups/{group_id}/actions/device-remove

请求参数

参数名类型参数位置是否必填说明
group_idStringuritrue群组 ID

body 说明

参数名类型参数位置是否必填说明
device_idsList false需移除的设备 ID 集

返回参数

参数名类型说明
resultGroupPackageTaskVO

result 说明

参数名类型说明
group_idString群组ID
task_idString任务ID
expire_timeLong过期时间,单位秒

请求示例

POST: /v1.0/iot-03/device-groups/14308xxxx887268904/actions/device-remove
{
  "device_ids": [
    "vdevo16292xxxx310895"
  ]
}

返回示例

{
    "result": {
        "expire_time": 10,
        "task_id": "143253xxxx5458899",
        "group_id": "14308xxxx887268904"
    },
    "t": 1630379063616,
    "success": true
}

错误码

参考 错误码