command CommandD
4.3.9.3 查询批量任务的子任务信息
典型场景
第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口 查询该批量任务中子任务的详情信息，如任务的执行状态、任务内容等。
接口功能
支持第三方应用根据条件查询批量任务中子任务的详情信息，支持查询本应用创建的 批量任务信息。
接口描述
def queryTaskDetails(self, qtdInDTO, accessToken)
接口所属类
BatchProcess
参数说明
参数 必选/可
选
类型 位置 描述
qtdInDTO 必选 QueryTask DetailsInDT O
query 见下表QueryTaskDetailsInDTO 的描述。
accessTok
en 必选 String header 填写鉴权接口获取的 accessToken。
QueryTaskDetailsInDTO 参数 必选/可
选
类型 位置 描述
appId 可选 String quer
y 如果是本应用的任务，此参数值可以填写 None，否则填写授权应用的appId。
taskId 必选 String quer
y 批量任务的ID。
status 可选 String quer
y 任务的详情状态，“Pending/Success/Fail/
Timeout”。
devic
eId 可选 String quer
y 设备Id，查询批量命令任务时使用。
command Id
可选 String quer
y 命令Id，查询批量命令任务时使用。
pageNo 可选 Intege
r quer
y 分页查询参数。
● 值为空时，查询内容不分页。
● 值为大于等于0的整数时，分页查询。
● 值为0时查询第一页。
pageS
ize 可选 Intege
r quer
y 分页查询参数，取值大于等于1的整数，缺省 值：“1”。
返回值
QueryTaskDetailsOutDTO
参数 类型 描述
pageNo Long 分页查询参数。
● 值为空时，查询内容不分页。
● 值为大于等于0的整数时，分页查询。
● 值为0时查询第一页。
pageSize Long 分页查询参数，取值大于等于1的整数，缺省 值：“1”。
totalCount Long 查询到的任务总数。
taskDetails List<QueryTaskD
etailDTOCloud2N A>
任务详情信息列表。
QueryTaskDetailDTOCloud2NA：
参数 类型 描述
status String 任务执行状态，取值范围：Pending/
WaitResult/Success/Fail/Timeout。
output String 批量下发命令的输出信息。
error String 任务的错误原因，格式为： {\"error_code\":
\"****\", \"error_desc\":\"*****\"}。
param
ObjectNode
不同任务类型的具体参数。ObjectNode：
参数 类型 描述
deviceId String 设备ID，用于唯一标识一个设备，在注册设备 时由物联网平台分配获得。
commandId String 下发的命令ID，用于唯一标识一条命令，在下 发设备命令时由物联网平台分配获得。
错误码
Http状态 码
错误码 错误描述 说明
400 100022 The input is
invalid 输入参数无效。
处理建议：请检查接口调用请求中 携带参数的合法性。
403 100203 The application is
not existed. 应用不存在。
处理建议：
● 请检查HTTP请求头域中携带的 appId是否有误。
● 请检查请求路径（url）中传入的 appId是否有误。
403 100217 The application hasn't been authorized
应用未被授权。
处理建议：若非应用授权场景，请 确认请求参数中的appId为空。
403 1010009 app throttle
exceed. 应用调用接口过于频繁，超过流控 值（默认值是100次/60s）。
处理建议：联系物联网平台维护人 员调大流控阈值或者控制接口的调 用频率。
403 1010005 Invalid access
token or appId. 错误的token信息。
处理建议：请检查接口请求中所携 带的accessToken是否有误。
404 105005 The batchTask is
not existed. 批量任务不存在。
处理建议：请检查接口请求中的 taskId是否有误。
500 100203 The application is
not existed. 应用不存在。
处理建议：
● 请检查HTTP请求头域中携带的 appId是否有误。
● 请检查请求路径（url）中传入的 appId是否有误。
500 50252 Internal server
error. 服务器运行内部错误。
处理建议：物联网平台内部错误，
请联系物联网平台维护人员处理。