云服务 API 参考行业场景[旧版] 设备群组管理设备组管理获取群组设备任务详情

获取群组设备任务详情

更新时间：2023-07-06 08:00:13下载pdf

本文介绍获取群组设备任务详情的 API。

接口描述

通过群组 ID，获取群组任务详情。

接口地址

GET: /v1.0/iot-03/device-groups/{group_id}/tasks

请求参数

参数名	类型	参数位置	是否必填	说明
group_id	String	uri	true	群组 ID
req	GroupTaskQueryReq	query	false	查询条件

req 说明

参数名	类型	参数位置	是否必填	说明
task_id	String		false	任务 ID，默认最新一条任务

返回参数

参数名	类型	说明
result	GroupTaskStatusVO

result 说明

参数名	类型	说明
group_id	String	群组 ID
processing_status	Integer	群组异步任务的执行状态 0：设备操作中 1：设备操作全部成功 2：设备操作部分成功 3：设备操作全部失败
failure_devices	List	失败设备列表

failure_devices 说明

参数名	类型	说明
device_id	String	设备 ID
op	Integer	操作类型 0：群组增加设备 1：群组删除设备
reason	String	失败原因

请求示例

GET: /v1.0/iot-03/device-groups/144779744804601****/tasks

{}

返回示例

{
    "result": {
        "failure_devices": [
            {
                "op": 0,
                "reason": "SUB_DEVICE_TIMEOUT",
                "device_id": "vdevo1632553122****"
            },
            {
                "op": 0,
                "reason": "SUB_DEVICE_TIMEOUT",
                "device_id": "vdevo1632553121****"
            },
            {
                "op": 0,
                "reason": "SUB_DEVICE_TIMEOUT",
                "device_id": "vdevo1632553120****"
            },
            {
                "op": 0,
                "reason": "SUB_DEVICE_TIMEOUT",
                "device_id": "vdevo1632553119****"
            }
        ],
        "group_id": "144779744804601****",
        "processing_status": 2
    },
    "t": 1633945074303,
    "success": true
}

错误码

参考错误码。

上一篇添加设备入设备群组

下一篇[旧版] 通用场景联动