- 产品介绍
- 价格说明
- 快速入门
- 开发指南
- 用户指南
- 最佳实践
- 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（联通用户专用）
- 编解码插件（联通用户专用）
- 软/固件升级（联通用户专用）
- 文档下载
- 通用参考
链接复制成功！
查询指定任务的子任务详情
接口说明
在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。应用服务器可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。
URI
|
请求方法 |
GET |
|---|---|
|
URI |
/iodm/northbound/v1.5.0/operations/{operationId}/subOperations |
|
传输协议 |
HTTPS |
请求参数
|
参数 |
必选/可选 |
类型 |
位置 |
描述 |
|---|---|---|---|---|
|
app_key |
必选 |
String |
header |
访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 |
|
Authorization |
必选 |
String |
header |
访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。 |
|
operationId |
必选 |
String |
path |
操作任务ID，在创建操作任务后由物联网平台返回获得。 |
|
subOperationStatus |
可选 |
String |
query |
子任务状态，不指定，则查询该任务下所有子任务执行详情。
|
|
pageNo |
可选 |
Integer(>=0) |
query |
分页查询参数，查询结果分页显示时指定要查看的页信息，默认值0，查询第一页，取值范围为大于等于0的整数。 |
|
pageSize |
可选 |
Integer[1,100] |
query |
分页查询参数，查询结果分页显示时每页显示的记录数，默认值为10，取值范围为1-100的整数。 |
响应参数
Status Code: 200 OK
|
参数 |
类型 |
描述 |
|---|---|---|
|
data |
List<SubOperationInfo> |
子任务列表信息。 |
|
pageNo |
Integer(>=0) |
查询结果的页码。 |
|
pageSize |
Integer[1,100] |
查询结果每页的记录数量。 |
|
totalCount |
Integer(>=0) |
查询结果的记录总数。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
subOperationId |
String |
子任务ID。 |
|
createTime |
String |
子任务创建的UTC时间，时间格式：yyyyMMdd'T'HHmmss'Z'，如：20151212T121212Z。 若需要显示本地时区时间，您需要自己进行时间转换。 |
|
startTime |
String |
子任务启动的UTC时间，时间格式：yyyyMMdd'T'HHmmss'Z'，如：20151212T121212Z。 若需要显示本地时区时间，您需要自己进行时间转换。 |
|
stopTime |
String |
子任务停止的UTC时间，时间格式：yyyyMMdd'T'HHmmss'Z'，如：20151212T121212Z。 若需要显示本地时区时间，您需要自己进行时间转换。 |
|
operateType |
String |
操作类型。
|
|
deviceId |
String |
操作设备的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 |
|
status |
String |
子任务状态。
|
|
detailInfo |
String |
任务状态的详细描述，对于失败场景下为失败原因。 |
|
extendPara |
Map<String, String> |
任务扩展信息，视不同类型的操作不同。 |
请求示例
GET https://{host}:{port}/iodm/northbound/v1.5.0/operations/{operationId}/subOperations?subOperationStatus={subOperationStatus}&pageNo={pageNo}&pageSize={pageSize}
Content-Type: application/json
app_key: ******
Authorization: Bearer ******正常响应示例
Status Code: 200 OK
Content-Type: application/json
{
"totalCount": 1,
"pageNo": 0,
"pageSize": 1,
"date": [
{
"subOperationId": "**********",
"createTime": "20151212T121212Z",
"startTime": "20151212T121212Z",
"stopTime": null,
"operateType": "software_upgrade",
"deviceId": "**********",
"status": "FAIL",
"detailInfo": "The task failed to start, unable to find protocol service based on device information",
"extendInfo": {
"upgradeTime": null,
"sourceVersion": null,
"curVersion": "V1.1.10",
"downloadTime": null,
"targetVersion": null
}
}
]
}错误码
|
Http状态码 |
错误码 |
错误描述 |
说明 |
|---|---|---|---|
|
400 |
120015 |
Bad request error. |
请求错误。 处理建议：请检查接口请求中fileId的格式是否正确。 |
|
400 |
123029 |
pageNo or pageSize beyond the limit. |
pageNo或pageSize超出上限。 处理建议：修改pageNo或pageSize为合法取值。 |
|
403 |
1010009 |
app throttle exceed. |
应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 |
|
403 |
1010005 |
Invalid access token or appId. |
错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 |
|
404 |
123009 |
The requested task does not exist. |
查询的任务不存在。 处理建议：请检查接口请求中的operationId内容是否正确。 |
