检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
状态,可尝试上报一条数据。 如果命令状态为已发送或超时,说明命令已经由物联网平台送出,建议先检查设备是否已收到命令,因为超时是指设备没有在规定时间内返回ACK,不一定代表设备为接收到命令。 若设备确实没收到命令,请联系运营商检查网络侧。 如果命令状态为已送达,说明物联网平台已经收
命令下发 创建设备命令 查询设备命令 修改设备命令 创建设备命令撤销任务 查询设备命令撤销任务 设备服务调用 父主题: 应用侧JAVA SDK API参考(联通用户专用)
平台能批量下发命令吗? 通过调用物联网平台的创建批量任务接口可以进行批量命令下发。 通过创建批量任务下发的命令为缓存命令。 父主题: 命令下发(联通用户专用)
命令下发 创建设备命令 查询设备命令 修改设备命令 批量创建设备命令 创建设备命令撤销任务 查询设备命令撤销任务 设备命令下发 父主题: 应用侧API参考(联通用户专用)
命令下发 创建设备命令 查询设备命令 修改设备命令 创建设备命令撤销任务 查询设备命令撤销任务 设备服务调用 父主题: 应用侧Python SDK API参考(联通用户专用)
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。
查询设备命令 接口说明 应用服务器向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommands
修改设备命令 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态
查询设备命令 典型场景 第三方应用向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况。 接口功能 支持第三方应用在物联网平台查询下发命令的状态和内容信息,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。 接口描述 1
查询设备命令 典型场景 第三方应用向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况。 接口功能 支持第三方应用在物联网平台查询下发命令的状态和内容信息,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。 接口描述 1
设备命令下发 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令,设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设
接收设备命令 接口功能 注册设备命令接收广播来接收处理平台下发的控制命令。 接口描述 1 DataTransService.TOPIC_COMMAND_RECEIVE; 返回结果 广播名称 广播参数 成员 描述 TOPIC_COMMAND_RECEIVE IotaMessage
upLimit. 缓存的命令数已到达限制。处于PENDING状态的命令条数不超过限定值。默认限定值为20。 处理建议:如当前平台缓存的命令还需执行,请让设备上报数据触发缓存命令的下发;如当前平台缓存的命令有不需要执行的命令,请调用“修改设备命令V4”接口,将命令的状态从PENDING修改未CANCELED。
接收设备命令 接口功能 调用设备命令接收接口来处理平台下发的控制命令。 接口描述 1 DataTransService.TOPIC_COMMAND_RECEIVE; 接口所属类 DataTransService 示例 开发者需要实现Agent Lite提供的观察者接口。 1
String 命令内容,以Json格式进行拼装的服务命令参数,开发者根据对应服务命令的定义进行Json解析,从而获取命令参数值。 示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 // 开发者注册该函数进行命令接收的处理
修改设备命令 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态
息。 mid 必选 Integer 命令ID,把物联网平台下发命令时携带的“mid”返回给平台。 errcode 必选 Integer 命令执行的结果码。 “0”表示执行成功。 “1”表示执行失败。 body 可选 ObjectNode 命令的应答,具体字段在设备的产品模型中定义。
String 下发命令的状态。 DEFAULT表示未下发 EXPIRED表示命令已经过期 SUCCESSFUL表示命令已经成功执行 FAILED表示命令执行失败 TIMEOUT表示命令下发执行超时 CANCELED表示命令已经被撤销执行 result ObjectNode 下发命令执行的详细结果。
设备收到命令需要多长时间? 在开发中心的“设备管理 > 历史命令”中查看命令详情,已发送的时间为命令离开物联网平台的时间,已送达的时间为物联网平台收到设备返回的ACK的时间。开发者可以据此推算命令下发到设备需要的大概时间,该数据受NB网络状态的影响。 父主题: 命令下发(联通用户专用)
批量创建设备命令 应用服务器若需要向多个设备下发相同的设备命令时,可调用此接口向批量设备下发命令。 此功能通过创建批量任务接口向设备下发批量任务实现,“taskType”参数设置为“DeviceCmd”时,为向批量设备下发命令。 父主题: 命令下发