检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
删除设备通知 典型场景 第三方应用在物联网平台订阅了删除设备通知后（订阅的通知类型为deviceDeleted），当设备在物联网平台中被删除后，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了删除设备通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台
删除设备通知 典型场景 第三方应用在物联网平台订阅了删除设备通知后（订阅的通知类型为deviceDeleted），当设备在物联网平台中被删除后，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了删除设备通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数
命令状态变化通知 接口说明 应用服务器通过物联网平台创建设备命令时，如果设置了callbackurl回调地址，当命令状态变化时（执行失败，执行成功，超时，发送，已送达），平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI
设备事件通知 典型场景 第三方应用在物联网平台订阅了设备事件通知后（订阅的通知类型为deviceEvent），当平台收到设备上报的事件消息时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业
设备事件通知 典型场景 第三方应用在物联网平台订阅了设备事件通知后（订阅的通知类型为deviceEvent），当平台收到设备上报的事件消息时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据
报表统计 - √ - 设备发放 通过设备发放服务，您可以轻松管理跨多区域海量设备的发放工作，实现单点发放管理，设备全球上线。 功能 简介 设备启动引导 通过Bootstrap流程，引导物联网设备在初次上电时获得正确的目标物联网平台地址，继而完成设备与平台的建链过程。 设备身份信息鉴权
可选 String(256) body 设备验证码，若在请求中指定verifyCode，则响应中返回请求中指定的verifyCode；若请求中不指定verifyCode，则由物联网平台自动生成。 对于集成了Agent Lite SDK的设备，必须与nodeId设置成相同值。 响应参数
可选 String Body 设备密码，格式要求为20位16进制数。若在请求中指定secret，则响应中返回请求中指定的secret；若请求中不指定secret，则由物联网平台自动生成。 DeviceInfo： 参数 必选/可选 类型 位置 描述 nodeId 必选 String(256)
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
NOT_ACTIVE 设备向物联网平台上报设备状态时需要status、statusDetail成对上报。statusDetail建议仅用作显示，不建议用于逻辑判断。 响应参数 Status Code: 200 OK 请求示例 Method: POST request: {callbackUrl}
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后（订阅的通知类型为deviceDataChanged），当设备上报单个服务属性数据时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项
通讯，CoAP消息的payload为应用层数据，应用层数据的格式由设备自行定义。由于NB-IoT设备一般对省电要求较高，所以应用层数据一般不采用流行的JSON格式，而是采用二进制格式。但是，物联网平台与应用侧使用JSON格式进行通信。因此，您需要开发编码插件，供物联网平台调用，以完成二进制格式和JSON格式的转换。
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后（订阅的通知类型为deviceDataChanged），当设备上报单个服务属性数据时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 1
parameter is error, targetversion not match with device. 参数不正确，目标版本与指定设备不匹配。 处理建议：请检查接口请求中deviceType、manufacturerName、model，与参数fileId指定的目标版本包信息是否一致。
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时，可调用此接口删除指定的订阅配置，取消订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId} 传输协议
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQ
其他厂家芯片的设备唯一标识请联系模组厂家确认。 psk 可选 String(8-32) Body 请求中指定psk，则平台使用指定的psk；请求中不指定psk，则由平台生成psk。取值范围是a-f、A-F、0-9组成的字符串。 timeout 可选 Integer(>=0) Body 设
调用订阅接口时，回调地址如何获取？ 以业务应用订阅设备数据变化通知为例，订阅和推送的流程如下： 应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知（携带回调地址和通知类型），物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
