检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修改设备信息 典型场景 第三方应用在物联网平台注册设备后，若设备的基本信息发生变更，也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 void modifyDeviceInfo(M
设备登出 接口功能 断开与物联网平台的连接。 接口描述 1 HW_INT IOTA_Logout(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果，返回0只是说明接口调用成功。 示例 1 2 // 开发者调用设备登出接口： IOTA_Logout(); 父主题：
通过网关接入的子设备，平台如何识别是哪一个设备？ 网关信息请在“设备信息”中查看，子设备信息请在“子设备”中查看。点击了解更多网关和子设备介绍。 父主题： 设备集成（联通用户专用）
上报设备数据 接口功能 当直连设备（网关）有数据需要上报或者非直连设备上报数据到网关时，网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的pcDeviceId、pcRequstId和pcServiceId由SDK组装为消息的header；pcServic
设备接入服务如何获取设备数据？ 设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 需要注意的是设备接入服务不解析数据，若设备采用二进制上报数据，则平台进行码流base64封装后再转发。 父主题：
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。第三方应用可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
查询设备影子 典型场景 若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方
IoT设备如何激活？ 在物联网平台中，激活就是将真实设备在平台进行注册后，和平台进行连接或者上报数据。更多请查看设备监控。 开发中心没有未激活状态，设备在线，您可认为设备就已激活。 父主题： 设备集成（联通用户专用）
刷新设备密钥 典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的no
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：
设备触发告警并邮件或短信通知（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 很多物联网设备24小时运行，设备管理者并不需要知道设备每一刻的状态，只需要设备在上报某些特定状态时能通知到管理者。 设备管理服务提供规则引擎功能可以满足该诉求，您可以通过设置规则简单实现当设备
可根据设备是否处于休眠状态缓存消息或者立即下发消息。 终端设备兼顾低功耗和对时延有一定要求的业务，如远程关闭煤气业务。 不等待设备上报数据，平台排队下发命令 2*eDRX周期+120秒 由于终端设备的省电模式是在运营商网络侧设置的，物联网平台无法从终端设备和网络侧获取到设备的省电
查询设备影子 接口说明 若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。应用服务器可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 注意事项 当前仅使用
典型场景 若需要对设备进行固件版本升级，第三方应用可调用此接口为多个设备创建固件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行固件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行固件版本升级，当前仅支持对NB-IoT设备进行固件版本升级。
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
本示例为设备自带的温度传感器上报的温度大于80度时，平台自动下发命令关闭设备。 配置设备管理服务 在设备管理服务中创建产品模型、注册设备并设置设备联动规则，实现当设备上报特定数据时平台自动下发命令。 登录华为云官方网站，访问“设备管理服务”。 单击“立即使用”进入设备管理控制台。
设备升级 查询版本包列表 查询指定版本包 删除指定版本包 创建软件升级任务 创建固件升级任务 查询指定任务信息 查询指定任务的子任务详情 查询任务列表 父主题： 应用侧API参考（联通用户专用）
典型场景 若需要对设备进行软件版本升级，第三方应用可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级，当前仅支持对NB-IoT设备进行软件版本升级。
删除子设备 若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时，则启动内部业务流程，删除子设备。
String(1-64) 设备命令撤销任务所属的应用ID。 deviceId String(1-64) 执行设备命令撤销任务的设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 status String 撤销任务的任务状态。 WAITTING表示等待执行中 RUNNING表示撤销任务正在执行
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
