- 最新动态
- 产品介绍
- 价格说明
- 快速入门
- 开发指南
- 用户指南
- 最佳实践
- 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(联通用户专用)
- 编解码插件(联通用户专用)
- 软/固件升级(联通用户专用)
- 文档下载
- 通用参考
链接复制成功!
查询设备命令
典型场景
第三方应用向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况。
接口功能
支持第三方应用在物联网平台查询下发命令的状态和内容信息,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。
接口描述
1 |
def queryDeviceCommand(self, qdcInDTO, accessToken) |
参数说明
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
qdcInDTO |
必选 |
QueryDeviceCommandInDTO |
query |
见下表QueryDeviceCommandInDTO的描述。 |
accessToken |
必选 |
String |
header |
填写鉴权接口获取的accessToken。 |
QueryDeviceCommandInDTO
参数 |
必选/可选 |
类型 |
位置 |
描述 |
---|---|---|---|---|
pageNo |
可选 |
Integer(>=0) |
query |
查询的页码,大于等于0,默认值:“0”。 |
pageSize |
可选 |
Integer(>=1&&<=1000) |
query |
查询每页信息的数量,大于等于1,最大值1000,默认值:“1000”。 |
deviceId |
可选 |
String(64) |
query |
指定查询命令的设备ID。 |
startTime |
可选 |
String |
query |
查询开始时间,查询下发命令时间在startTime之后的记录。时间格式:yyyyMMdd'T'HHmmss'Z',如 “20151212T121212Z”。 |
endTime |
可选 |
String |
query |
查询结束时间,查询下发命令时间在endTime之前的记录。时间格式:yyyyMMdd'T'HHmmss'Z',如 “20151212T121212Z”。 |
appId |
可选 |
String |
query |
如果是本应用的设备命令,此参数值可以填写None,否则填写授权应用的appId。 |
响应参数
QueryDeviceCommandOutDTO
参数 |
类型 |
描述 |
---|---|---|
pagination |
Pagination |
页面信息,具体参见Pagination结构体。 |
data |
List<DeviceCommandRespV4> |
设备命令列表,具体参见DeviceCommandRespV4结构体。 |
参数 |
类型 |
描述 |
---|---|---|
pageNo |
long |
页码。 |
pageSize |
long |
每页信息数量。 |
totalSize |
long |
记录总数。 |
参数 |
类型 |
描述 |
---|---|---|
commandId |
String(1-64) |
设备命令ID。 |
appId |
String(1-64) |
第三方应用的身份标识,用于唯一标识一个应用。开发者可通过该标识来指定哪个应用来调用物联网平台的开放API。 |
deviceId |
String(1-64) |
下发命令的设备ID,用于唯一标识一个设备。 |
command |
CommandDTOV4 |
下发命令的信息,具体参见CommandDTOV4结构体。 |
callbackUrl |
String(1024) |
令状态变化通知地址,当命令状态变化时(执行失败,执行成功,超时,发送,已送达)会通知第三方应用。 |
expireTime |
Integer(>=0) |
下发命令的超时时间,单位为秒,表示设备命令在创建后expireTime秒内有效,超过这个时间范围后命令将不再下发,如果未设置则默认为48小时(86400s*2)。 |
status |
String |
下发命令的状态。
|
result |
ObjectNode |
下发命令执行的详细结果。 |
creationTime |
String(20) |
命令的创建时间。 |
executeTime |
String(20) |
命令执行的时间。 |
platformIssuedTime |
String(20) |
平台发送命令的时间。 |
deliveredTime |
String(20) |
平台将命令送达到设备的时间。 |
issuedTimes |
Integer(>=0) |
平台发送命令的次数。 |
maxRetransmit |
Integer(0~3) |
命令下发最大重传次数。 |
参数 |
必选/可选 |
类型 |
描述 |
---|---|---|---|
serviceId |
必选 |
String(1-64) |
命令对应的服务ID,用于标识一个服务。 |
method |
必选 |
String(1-128) |
命令服务下具体的命令名称,服务属性等。 |
paras |
可选 |
Object |
命令参数的jsonString,具体格式需要应用和设备约定。 |
错误码
Http状态码 |
错误码 |
错误描述 |
说明 |
---|---|---|---|
200 |
100203 |
The application is not existed. |
应用不存在。 处理建议:
|
200 |
100217 |
The application hasn't been authorized. |
应用未被授权。 处理建议:若非应用授权场景,请确认请求参数中的appId为空。 |
200 |
100418 |
The deviceData is not existed. |
设备信息不存在。 处理建议:
|
200 |
100428 |
The device is not online. |
设备不在线。 处理建议:请检查设备与物联网平台的连接是否正常。 |
200 |
100431 |
The serviceType is not exist. |
服务类型不存在。 处理建议:
|
400 |
100022 |
The input is invalid. |
输入参数无效。 处理建议:
|
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是否有误。 |
500 |
100001 |
Internal server error. |
服务内部处理错误。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。 |
500 |
100023 |
The data in dataBase is abnomal. |
数据库异常。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。 |
500 |
100220 |
Get AppKey from header failed. |
获取appKey失败。 处理建议 : 请检查接口请求的header中是否携带appId。 |
500 |
101016 |
Get iotws address failed. |
获取iotws地址失败。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。 |
500 |
101017 |
Get newCallbackUrl from oss failed. |
从oss获取新的回调地址失败。 处理建议:物联网平台内部错误,请联系物联网平台维护人员处理。 |
503 |
100501 |
Congestion occurs, and the current network has been flow-controlled |
发生拥塞,当前的网络已经被流控。 |