删除群组

更新时间：2024-06-29 00:53:51下载pdf

本文介绍删除群组的 API。

接口描述

根据群组 ID，删除群组信息。

接口地址

DELETE: /v2.1/cloud/thing/group/{group_id}

请求参数

参数名	类型	参数位置	是否必填	说明
group_id	Long	path	true	群组 ID。

返回参数

参数名	类型	说明
result	JsonObject	返回群组数据结果。
success	Boolean	API 调用是否成功。 `true`：调用成功。 `false`：调用失败。
t	Long	时间戳。
tid	String	链路 ID。

result 说明

参数名	类型	说明
task_id	String	任务 ID。
task_type	Integer	任务类型。 `1`：添加，例如创建群组。 `2`：更新，例如添加设备入群组、从群组中移除设备。 `3`：删除，例如删除群组。
task_expire_second	Long	任务过期秒数。任务完成前，请勿再进行群组设备关系修改操作。

请求示例

DELETE: /v2.1/cloud/thing/group/1393****

返回示例

{
    "tid": "122bcc1e022d11efbe7a366d87620758",
    "result": {
        "task_id": "178309439872518****",
        "group_id": "1393****",
        "task_expire_second": 21,
        "task_type": 3
    },
    "t": 1713957807630,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。