- 产品介绍
- 价格说明
- 快速入门
- 开发指南
- 用户指南
- 最佳实践
- API参考
-
SDK参考
- SDK介绍（联通用户专用）
- 应用侧JAVA SDK API参考（联通用户专用）
- 应用侧Python SDK API参考（联通用户专用）
- 设备侧Agent Lite API参考(C)（联通用户专用）
- 设备侧Agent Lite API参考(Android)（联通用户专用）
- 设备侧Agent Lite API参考(Java)（联通用户专用）
-
常见问题
- 热门问题（联通用户专用）
-
方案咨询（联通用户专用）
- 开发中心、设备接入和设备管理的差异是什么？
- IAM子用户或子项目是否可以开通物联网平台服务？
- 物联网平台支持在华为云的哪些区域开通？
- 如何成为华为IoT生态合作伙伴？
- 物联网平台支持哪些接入方式和协议？
- 华为是否提供模组/硬件终端/应用软件等？
- 设备接入模拟器HubSimulator是否能在设备管理使用？
- 设备接入服务如何获取设备数据？
- 物联网平台的应用和设备可以无限创建吗？
- 物联网平台支持批量注册设备吗？
- 物联网平台对应用和设备有消息流控吗？
- 开发中心单个应用允许接入设备数是多少？
- 数据在物联网平台的保存时间是多久？
- 物联网平台支持的DTLS加密算法有哪些？
- 物联网平台支持二进制大小端模式切换吗？
- 什么是NB-IoT？
- 物联网平台支持的硬件架构和使用的相关组件有哪些？
-
设备集成（联通用户专用）
- 如何获取设备和应用对接地址？
- 如何下载LiteOS IDE/IoT Studio?
- 物联网平台允许一个IMEI号注册多个设备吗？
- 如何设置设备名称？
- IoT设备如何激活？
- 物联网平台如何切换设备的在线/离线状态？
- 通过网关接入的子设备，平台如何识别是哪一个设备？
- deviceId、nodeId和IMEI有什么对应关系？
- Agent Lite和Agent Tiny有什么区别？
- 使用Agent Lite接入的网关设备gwbindinfo.json文件丢失如何处理？
- 运行Agent Lite Java Demo报UnsatisfiedLinkError错误怎么处理？
- 设备如何发送文件至物联网平台？
- 开发中心模拟设备如何上报负数？
- 开发中心支持哪几种省电模式？
- 开发中心支持数据转发吗？
- 开发中心没有设备分组和批量添加设备，怎么办？
- 如何检测NB网络信号？
- NB模组附着网络失败如何处理？
- NB模组绑定设备失败怎么办？
- NB模组无法正常上报数据怎么办？
- NB设备上报数据为字符串时如何转换为二进制编码？
- NB设备接入时，出现513错误？
- 为什么执行AT+CUFN=1会返回error？
- 平台向NB-IoT设备缓存下发命令，为什么设备一直收到同一条控制命令？
- AT+CGDCONT=1, CTNB是什么？
- NB-IoT设备如何选择PSM、DRX、eDRX模式？
- 应用集成（联通用户专用）
-
订阅推送（联通用户专用）
- 调用订阅接口时，回调地址如何获取？
- 应用服务器如何收到命令状态变化的通知？
- 如何获取证书？
- 回调地址可以使用域名吗？
- 订阅后消息推送失败，例如提示503如何处理？
- 应用服务器收到数据，但是平台显示推送失败？
- 应用服务器只有内网地址，能否订阅成功？
- 调用订阅接口时，提示回调地址不合法？
- 物联网平台只支持HTTPS的回调地址吗？
- 回调地址可以修改吗？
- 推送证书失效怎么处理？
- 调用删除单个订阅接口时，subscriptionId如何获取？
- 设备数据变化通知和批量设备数据变化通知的区别是什么？
- 应用服务器如何获取物联网平台推送消息时使用的地址？
- 物联网平台订阅推送是否具有重推机制？
- 为什么设备上报一条数据后应用服务器会收到多条推送？
- 在同一个应用下，平台可以将不同设备上报的数据，推送到两个服务器吗？
- NB-IoT设备已订阅消息确认和命令响应通知，为何应用服务器收不到推送消息？
- 数据上报（联通用户专用）
- 命令下发（联通用户专用）
- 产品模型/Profile（联通用户专用）
- 编解码插件（联通用户专用）
- 软/固件升级（联通用户专用）
- 文档下载
- 通用参考
链接复制成功！
查询指定批量任务信息
典型场景
第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务的信息，包括任务的当前状态、子任务完成情况等。
接口功能
支持第三方应用通过任务ID查询单个批量任务的信息。
接口描述
1 |
QueryOneTaskOutDTO queryOneTask(String taskId, String select, String appId, String accessToken) throws NorthApiException |
接口所属类
BatchProcess
参数说明
返回值
QueryOneTaskOutDTO
|
参数 |
类型 |
描述 |
|---|---|---|
|
appId |
String |
批量任务所归属的appId。 |
|
taskId |
String |
批量任务ID。 |
|
taskName |
String |
批量任务名称。 |
|
operator |
String |
下发该批量任务的操作员。 |
|
taskFrom |
String |
批量任务的来源。
|
|
taskType |
String |
批量任务的类型，取值范围：DeviceCmd。 |
|
status |
String |
批量任务的状态，取值范围：Pending/Running/Complete/Timeout。 |
|
startTime |
String |
批量任务的创建时间。 |
|
timeout |
Integer |
批量任务的超时时间，单位秒。 |
|
progress |
Integer |
批量任务的进度，单位：千分比，范围：0-1000，向下取整。 |
|
totalCnt |
Integer |
任务的总数。 |
|
successCnt |
Integer |
成功的任务数。 |
|
failCnt |
Integer |
失败的任务数。 |
|
timeoutCnt |
Integer |
超时的任务数。 |
|
expiredCnt |
Integer |
未执行的失效任务数。 |
|
completeCnt |
Integer |
完成的任务数，完成的任务数=成功的任务数+失败的任务数+超时的任务数。 |
|
successRate |
Integer |
任务成功率，单位：千分比，范围：0-1000，向下取整。 |
|
param |
不同任务类型的具体参数。 |
|
|
tags |
List<TagDTO2> |
批量任务的标签列表。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
type |
String |
批量命令类型，取值范围： DeviceList/DeviceType/DeviceArea/GroupList/Broadcast/GroupIdList。 |
|
deviceList |
List<String> |
设备ID列表，type为DeviceList时返回值。 |
|
deviceType |
String |
设备类型，type为DeviceType时返回值，其值应当与profile中定义的一致。 |
|
manufacturerId |
String |
厂商ID，type为DeviceType时返回值，其值应当与profile中定义的一致。 |
|
model |
String |
设备型号，type为DeviceType时返回值，其值应当与profile中定义的一致。 |
|
deviceLocation |
String |
设备位置，type为DeviceArea时返回值。 |
|
groupList |
List<String> |
群组名称列表，type为GroupList时返回值。 |
|
command |
命令信息。 |
|
|
callbackUrl |
String |
命令执行结果的推送地址。 |
|
maxRetransmit |
Integer(0~3) |
命令下发最大重传次数，取值范围：0-3。 |
|
groupTag |
String |
群组标签。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
serviceId |
String(1-64) |
命令对应的服务ID，要与profile中定义的serviceId保持一致。 |
|
method |
String(1-128) |
服务下具体的命令名称，要与profile中定义的命令名保持一致。 |
|
paras |
ObjectNode |
命令参数，jsonString格式，里面是一个个健值对，每个健都是profile中命令的参数名（paraName），具体格式需要应用和设备约定。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
tagName |
String(1-128) |
标签名称。 |
|
tagValue |
String(1-1024) |
标签值。 |
错误码
|
Http状态码 |
错误码 |
错误描述 |
说明 |
|---|---|---|---|
|
400 |
100019 |
Illegal request. |
非法请求。 处理建议：请检查接口请求中的必须参数是否为空。 |
|
400 |
100022 |
The input is invalid |
输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 |
|
403 |
100203 |
The application is not existed. |
应用不存在。 处理建议：
|
|
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. |
应用不存在。 处理建议：
|
