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