获取群组设备任务详情

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

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

接口描述

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

接口地址

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

请求参数

参数名类型参数位置是否必填说明
group_idStringuritrue群组 ID
reqGroupTaskQueryReqqueryfalse查询条件

req 说明

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

返回参数

参数名类型说明
resultGroupTaskStatusVO

result 说明

参数名类型说明
group_idString群组 ID
processing_statusInteger群组异步任务的执行状态
  • 0:设备操作中
  • 1:设备操作全部成功
  • 2:设备操作部分成功
  • 3:设备操作全部失败
failure_devicesList失败设备列表

failure_devices 说明

参数名类型说明
device_idString设备 ID
opInteger操作类型
  • 0:群组增加设备
  • 1:群组删除设备
reasonString失败原因

请求示例

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
}

错误码

参考 错误码