检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接收设备命令 接口功能 调用设备命令接收接口来处理平台下发的控制命令。 接口描述 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 // 开发者注册该函数进行命令接收的处理
设备服务的ID。 cmd 必选 String 命令名称，在设备的产品模型中定义。 paras 必选 ObjectNode 命令参数，具体字段在设备的产品模型中定义。 mid 必选 Integer 命令ID，物联网平台内部分配（范围1-65535），设备响应平台命令时，需要返回该值。 示例 设备先
批量创建设备命令 应用服务器若需要向多个设备下发相同的设备命令时，可调用此接口向批量设备下发命令。 此功能通过创建批量任务接口向设备下发批量任务实现，“taskType”参数设置为“DeviceCmd”时，为向批量设备下发命令。 父主题： 命令下发
String 下发命令的状态。 DEFAULT表示未下发 EXPIRED表示命令已经过期 SUCCESSFUL表示命令已经成功执行 FAILED表示命令执行失败 TIMEOUT表示命令下发执行超时 CANCELED表示命令已经被撤销执行 result ObjectNode 下发命令执行的详细结果。
设备变为异常或者离线后，命令下发会成功吗? 立即下发会失败。 缓存下发会进入等待状态，等设备上线或者设备上报数据时再下发给设备，如果单个设备存在多条缓存命令，则进行排队串行下发。 更多请参考命令下发。 父主题： 命令下发（联通用户专用）
upLimit. 缓存的命令数已到达限制。处于PENDING状态的命令条数不超过限定值。默认限定值为20。 处理建议：如当前平台缓存的命令还需执行，请让设备上报数据触发缓存命令的下发；如当前平台缓存的命令有不需要执行的命令，请调用“修改设备命令V4”接口，将命令的状态从PENDING修改未CANCELED。
upLimit. 缓存的命令数已到达限制。处于PENDING状态的命令条数不超过限定值。默认限定值为20。 处理建议：如当前平台缓存的命令还需执行，请让设备上报数据触发缓存命令的下发；如当前平台缓存的命令有不需要执行的命令，请调用“修改设备命令V4”接口，将命令的状态从PENDING修改未CANCELED。
设备命令响应通知 典型场景 第三方应用在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向第三方应用推送通知消息。 接口功能 支持物
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销
取消：表示应用侧已经取消命令下发。 等待：表示命令在物联网平台缓存，还未下发给设备。 已发送：表示物联网平台已经将命令下发给设备。 已送达：表示物联网平台已经将命令下发给设备，且收到设备返回的ACK消息。 各命令状态之间的转换如下图所示： 父主题： 命令下发（联通用户专用）
API接口 功能 查询设备命令 应用服务器向设备下发命令后，可调用此接口在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况。 修改设备命令 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该
模拟器下发命令成功，调用API下发命令失败？ 根据API参考的创建设备命令接口，检查url、body、header的参数信息是否正确。 分别通过用模拟器和调用API接口下发相同的命令，比对历史命令中，两条命令的json消息体的差异。 父主题： 应用集成（联通用户专用）
设备命令响应通知 典型场景 第三方应用在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向第三方应用推送通知消息。 接口功能 支持物
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQ
设备上报了命令执行结果，但是命令状态未切换为成功？ 在开发中心的“设备管理 > 设备日志”中，打开日志功能。在设备上报命令执行结果后： 如果没有日志打印，说明消息没有到达平台。请检查网络侧和设备侧。 如果有日志打印，并且日志中没有错误提示，则可能插件中mid字段的配置有误。mid
命令下发（联通用户专用） 非联通用户请查看设备接入服务。 命令下发失败或设备收不到命令如何处理？ 设备变为异常或者离线后，命令下发会成功吗? 物联网平台下发命令有重发机制吗？ 物联网平台的命令状态总共有几种？ 设备收到命令需要多长时间? 平台能批量下发命令吗？
设备接收解绑定命令 接口功能 被动接收平台下发的解绑定命令，删除直连设备的配置信息并且释放所有资源。(接收到此命令说明设备已经从平台侧删除。) 接口描述 1 HubService.TOPIC_UNBINDDEVICE; 接口所属类 HubService。 示例 调用该接口需要实现Agent
平台向NB-IoT设备缓存下发命令，为什么设备一直收到同一条控制命令？ 设备收到平台下发的命令后，必须向平台返回ACK响应，平台才认为设备收到了命令，否则平台认为这条命令没有下发成功，会重复下发这条命令直到收到ACK响应或命令过期。 父主题： 设备集成（联通用户专用）
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
