检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询指定版本包 典型场景 在进行设备版本升级前，第三方应用可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。
查询指定版本包 典型场景 在进行设备版本升级前，第三方应用可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息
NB模组绑定设备失败怎么办？ 使用NB模组和真实NB网络接入物联网平台时，第一步就是接入平台绑定设备。 如果设备绑定失败，可能的原因有很多种，您可按照下述指导逐个定位排查问题。 在物联网平台上注册设备时，设备标识（对应应用侧注册设备接口的nodeId和verifyCode）是否为NB
接收设备命令 接口功能 注册设备命令接收广播来接收处理平台下发的控制命令。 接口描述 1 IOTA_TOPIC_SERVICE_COMMAND_RECEIVE/{deviceId}; 参数说明 枚举项 枚举值 类型 描述 EN_IOTA_DATATRANS_IE_RESULT 0
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息
创建固件升级任务 典型场景 若需要对设备进行固件版本升级，第三方应用可调用此接口为多个设备创建固件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行固件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行固件版本升级，当前仅支持对NB-IoT
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建议开发者使用该接口刷新非直连设备的状态
创建软件升级任务 典型场景 若需要对设备进行软件版本升级，第三方应用可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级，当前仅支持对NB-IoT
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建议开发者使用该接口刷新非直连设备的状态
创建软件升级任务 典型场景 若需要对设备进行软件版本升级，第三方应用可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级，当前仅支持对NB-IoT
修改设备影子 典型场景 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及第三方应用对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子
物联网平台的命令状态总共有几种？ 物联网平台命令下发包含如下状态： 超期：表示命令在物联网平台缓存时间超期，未向设备下发。 成功：表示物联网平台已经将命令下发给设备，且收到设备上报的命令执行结果。 失败：表示编解码插件解析为空，或执行结果响应里面有“ERROR CODE”等。 超时
查询指定升级任务子任务详情 典型场景 在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。第三方应用可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务中每个设备的升级执行情况
修改设备影子 接口说明 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及应用服务器对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子
修改设备影子 典型场景 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及第三方应用对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子
查询指定升级任务子任务详情 典型场景 在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。第三方应用可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务中每个设备的升级执行情况
数据类型说明 常用数据类型 类型名称 类型原型 HW_INT int HW_UINT unsigned int HW_CHAR char HW_UCHAR unsigned char HW_BOOL int HW_ULONG unsigned long HW_USHORT unsigned
调测证书制作（联通用户专用） 非联通用户请查看设备接入服务。 调测证书，又叫做自签名证书，用于客户端通过HTTPS访问服务端时进行安全认证。在物联网平台的使用中，可用于物联网平台向应用服务器采用HTTPS协议推送数据时，物联网平台认证应用服务器的合法性。本文以Windows环境为例
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
