设备群组移除设备

更新时间：2023-07-06 07:51:05下载pdf

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

接口描述

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

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
group_id	String	uri	true	群组 ID

body 说明

参数名	类型	参数位置	是否必填	说明
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/14308xxxx887268904/actions/device-remove

{
  "device_ids": [
    "vdevo16292xxxx310895"
  ]
}

返回示例

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

错误码

参考错误码。