检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备命令下发 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设
API接口 功能 查询设备命令 应用服务器向设备下发命令后，可调用此接口在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况。 修改设备命令 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态
状态，可尝试上报一条数据。 如果命令状态为已发送或超时，说明命令已经由物联网平台送出，建议先检查设备是否已收到命令，因为超时是指设备没有在规定时间内返回ACK，不一定代表设备为接收到命令。 若设备确实没收到命令，请联系运营商检查网络侧。 如果命令状态为已送达，说明物联网平台已经收
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态
息。 mid 必选 Integer 命令ID，把物联网平台下发命令时携带的“mid”返回给平台。 errcode 必选 Integer 命令执行的结果码。 “0”表示执行成功。 “1”表示执行失败。 body 可选 ObjectNode 命令的应答，具体字段在设备的产品模型中定义。
String 命令内容，以Json格式进行拼装的服务命令参数，开发者根据对应服务命令的定义进行Json解析，从而获取命令参数值。 示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 // 开发者注册该函数进行命令接收的处理
设备收到命令需要多长时间? 在开发中心的“设备管理 > 历史命令”中查看命令详情，已发送的时间为命令离开物联网平台的时间，已送达的时间为物联网平台收到设备返回的ACK的时间。开发者可以据此推算命令下发到设备需要的大概时间，该数据受NB网络状态的影响。 父主题： 命令下发（联通用户专用）
upLimit. 缓存的命令数已到达限制。处于PENDING状态的命令条数不超过限定值。默认限定值为20。 处理建议：如当前平台缓存的命令还需执行，请让设备上报数据触发缓存命令的下发；如当前平台缓存的命令有不需要执行的命令，请调用“修改设备命令V4”接口，将命令的状态从PENDING修改未CANCELED。
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销
固件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了固件升级结果通知后（订阅的通知类型为fwUpgradeResultNotify），当设备的固件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级结果通知的第三方应用推送通知消息。
固件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了固件升级结果通知后（订阅的通知类型为fwUpgradeResultNotify），当设备的固件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级结果通知的第三方应用推送通知消息。
物联网平台下发命令有重发机制吗？ 物联网平台具备命令重发机制。命令发送后（可以在开发中心/设备接入/设备管理的命令详情中查看命令发送时间）：如果物联网平台未收到设备返回的ACK，则在10s~15s后会进行第一次重传。如果物联网平台仍未收到设备返回的ACK，在20s~30s后进行第
在线开发的插件中如何实现命令下发响应？ 设备在接收到命令后，可以上报两类消息：ACK和命令下发响应。ACK用于表示命令已经到达设备，命令下发响应用于表示设备执行命令的结果。如果需要设备在接到命令后，需要返回命令下发响应，则： 需要在数据上报消息和命令响应消息中均定义地址域字段（m
返回结果 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，物联网平台返回的状态码如下所示。 对于鉴权接口，如果调用后返回状态码为“200”，则表示请求成功。 状态码 编码 状态码说明 200
Integer query 分页查询参数，查询结果分页显示时指定要查看的页信息，默认值0，查询第一页，取值范围为大于等于0的整数。 pageSize 可选 Integer query 分页查询参数，查询结果分页显示时每页显示的记录数，默认值为10，取值范围为大于等于1的整数。 响应参数 Status
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 Q
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
