检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
发布数据 接口功能 当直连设备（网关）有数据需要发布或者非直连设备发布数据到网关时，网关需要调用设备服务数据发布接口将数据发布到物联网平台。其与数据上报功能上的区别在于，发布数据的topic固定为“/cloud/signaltrans/v2/categories/data”；“serviceData
查询升级任务列表 典型场景 第三方应用可调用此接口查询已创建的升级任务列表信息，以了解当前已有的升级任务信息及各个任务的执行情况。 接口功能 支持第三方应用在物联网平台查询升级任务的列表信息，可根据条件查询满足要求的升级任务信息。 接口描述 1 QueryUpgradeTaskListOutDTO
修改设备命令 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令，且当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后，可调用此接口查询设备命令撤销任务的详细信息和执行状态，以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态，可指定条件查询单个或多个撤销任务。 接口描述 1 QueryDeviceCmdCancelTaskOutDTO2
查询升级任务列表 典型场景 第三方应用可调用此接口查询已创建的升级任务列表信息，以了解当前已有的升级任务信息及各个任务的执行情况。 接口功能 支持第三方应用在物联网平台查询升级任务的列表信息，可根据条件查询满足要求的升级任务信息。 接口描述 1 def queryUpgradeTaskList
发布数据 接口功能 当直连设备（网关）有数据需要发布或者非直连设备发布数据到网关时，网关需要调用设备服务数据发布接口将数据发布到物联网平台。其与数据上报功能上的区别在于，发布数据的topic固定为“/cloud/signaltrans/v2/categories/data”；“serviceData
删除设备 接口功能 当有新设备需要从网关移除时，通过调用设备删除接口将非直连设备从物联网平台删除。 接口描述 1 public static boolean rmvDevice(int cookie, String deviceId); 接口所属类 HubService 参数说明
NB设备接入时，出现513错误？ 终端设备每次上电后，都会向物联网平台发起TUP注册流程。TUP协议为华为私有协议，包装在CoAP协议之上，与LWM2M协议类似。海思芯片设置TUP注册过程不能超过4s，如果在4s内未完成TUP注册，则上报513错误。 当出现此513错误时，可以按照如下方法进行处理
查询指定升级任务结果 典型场景 在创建了设备软件升级任务或固件升级任务后，第三方应用可调用此接口查询某个升级任务详细信息，以查看升级任务的配置信息和执行情况等。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务的详细信息，包括升级任务的配置信息和执行情况等。 接口描述
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态信息
设备侧适配开发指导（联通用户专用） 概述 设备的OTA软件升级是基于华为定义的PCP协议进行的，设备侧需根据PCP协议定义的交互流程进行适配开发。下面我们将结合物联网平台与设备的软件升级交互流程，介绍终端设备将如何基于PCP协议构建交互过程中的请求消息和应答消息，帮助您更好的根据PCP
查询指定升级任务结果 典型场景 在创建了设备软件升级任务或固件升级任务后，第三方应用可调用此接口查询某个升级任务详细信息，以查看升级任务的配置信息和执行情况等。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务的详细信息，包括升级任务的配置信息和执行情况等。 接口描述
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态信息
设备数据变化通知和批量设备数据变化通知的区别是什么？ 设备数据变化通知和批量设备数据变化通知接口都是订阅设备的数据变化，只是封装的数据格式不一样。 例如：一款水表设备有Battery和Connectivity两种服务类型，每次上报数据都会上报这两个服务的数据。 如果订阅deviceDatachanged
命令下发失败或设备收不到命令如何处理？ 调测设备命令下发前，请务必先调通设备上报数据，确保设备能成功上报数据至物联网平台。 给使用LWM2M/CoAP协议接入的设备，例如NB-IoT设备下发命令时需要使用创建设备命令接口，如果调用接口失败请参考接口文档的错误码描述修改请求重新发送。
数据上报失败如何处理？ 若设备是使用接口注册的，请确认设备是否因为没在指定的timeout时间内上线而被物联网平台自动删除了。如果设备已被删除，请重新注册设备再尝试上报数据。 请检查使用接口注册设备时，填写的产品信息是否和产品profile一致。 请检查上报的数据名称是否和产品模型定义的服务属性一致
修改设备影子 典型场景 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及第三方应用对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置，此时可把要下发的配置设置到设备影子
增加设备组成员 典型场景 若需要把新增的设备或已有设备增加到某个设备组中，第三方应用可调用此接口向指定设备组添加设备成员。在向设备组添加设备前，建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制，确保设备组中还有足够的可添加成员数量。 接口功能 支持第三方应用在物联网平台向指定设备组添加设备
查询指定升级任务子任务详情 典型场景 在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。第三方应用可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务中每个设备的升级执行情况
设备影子（联通用户专用） 非联通用户请查看设备接入服务。 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性值
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
