检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备影子 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性值，这个同步可以是影子同步给设备，也可以是设备同步给影子
产品开发指引 在物联网平台集成解决方案中，物联网平台作为承上启下的中间部分，向应用服务器开放API接口，向各种协议的设备提供API对接。为了提供更加丰富的设备管理能力，物联网平台需要理解接入设备具备的能力以及设备上报数据的格式，因此，您需要在控制台上完成产品模型和插件的开发。 产品模型是用来描述设备能力的文件
创建网桥 功能介绍 应用服务器可调用此接口在物联网平台创建一个网桥，仅在创建后的网桥才可以接入物联网平台。 一个实例最多支持20个网桥。 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id
设备侧获取平台的设备影子数据 功能介绍 用于设备向平台获取设备影子数据。用户可以通过应用服务器或物联网控制台配置设备影子预期数据，设备上线时订阅该topic，可以获取到平台设备影子数据，以此来同步设备属性期望值，从而完成设备属性值的修改。 简单交互逻辑介绍如下： ① 应用调用“配置设备影子预期数据
MQTT客户端接入说明 在调用创建规则触发条件、创建规则动作和修改规则触发条件配置并激活规则后，您需要参考本文将MQTT客户端接入物联网平台，成功接入后，在您的服务端运行MQTT客户端，即可接收订阅的消息。 连接配置说明 MQTT客户端接入物联网平台的连接地址和连接认证参数说明如下
广播通信概述 概述 广播通信常用于一对多的消息通信。多个设备订阅相同的广播Topic，应用服务器调用广播消息下发的接口指定广播Topic的名称，就可以给已订阅该广播Topic的所有在线设备发布消息。广播模式的典型用途是根据设备的类别向设备发送通知。 例如，地震局给指定区域内的所有公民发送地震预警信息
数据转发积压策略配置 概述 当转发目标（如第三方应用服务器等）由于性能等原因无法快速处理IoT物联网平台流转数据时，未能及时处理的流转数据会积压（缓存）在IoT物联网平台。目前IoT物联网平台默认配置单个转发规则流转数据的最大积压（缓存）大小为1GB，最大积压（缓存）时间为24小时
批量设备OTA升级 上传软固件包 创建批量设备软件、固件升级任务前需要上传软件升级包，平台支持两种方式上传软件、固件包： 应用服务器通过调用“创建OTA升级包”API接口，创建OTA升级包，详情请参考创建OTA升级包。 通过控制台，在软固件升级页面上传软件、固件升级包，详情请参考软固件包上传
按需转包年/包月 如果您需要长期使用设备接入标准版服务，可以将设备接入标准版实例转为包年/包月计费模式，以节省开支。按需计费变更为包年/包月会生成新的订单，用户支付订单后，包年/包月资源将立即生效。 假设用户于2023/04/18 15:29:16开通了按需计费的标准版低频单元S1
包年/包月转按需 购买包年/包月设备接入实例后，您可以将该设备接入实例的计费模式转为按需计费，回收部分成本，同时更加灵活地使用设备接入服务。 包年/包月转按需，支持两种方式： 即时转按需：按需的计费模式立即生效。 到期转按需：包年/包月计费模式到期后，按需的计费模式才会生效。 约束与限制
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则，用于子设备自主选择网关设备上线和上报消息，即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理
查询设备影子数据 功能介绍 应用服务器可调用此接口查询指定设备的设备影子信息，包括对设备的期望属性信息（desired区）和设备最新上报的属性信息（reported区）。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备
状态码 状态码如表1所示 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP
创建设备策略 功能介绍 应用服务器可调用此接口在物联网平台创建一个策略，该策略需要绑定到设备和产品下才能生效。 一个实例最多能创建50个设备策略。 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id
创建设备 功能介绍 应用服务器可调用此接口在物联网平台创建一个设备，仅在创建后设备才可以接入物联网平台。 该接口支持使用gateway_id参数指定在父设备下创建一个子设备，并且支持多级子设备，当前最大支持二级子设备。 该接口同时还支持对设备进行初始配置，接口会读取创建设备请求参数
配置设备影子预期数据 功能介绍 应用服务器可调用此接口配置设备影子的预期属性（desired区），当设备上线或者设备上报属性时把属性下发给设备。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识 设备影子用于存储设备上报的
灵活搜索设备列表 功能介绍 接口说明 应用服务器使用SQL语句调用该接口，灵活的搜索所需要的设备资源列表 限制 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数) 类SQL语法使用说明 类SQL语句由select、
消息通信相关问题 数据上报失败如何处理？ 若设备是使用接口注册的，请确认设备是否因为没在指定的timeout时间内上线而被物联网平台自动删除了。如果设备已被删除，请重新注册设备再尝试上报数据。 请检查使用接口注册设备时，填写的产品信息是否和产品模型一致。 请检查上报的数据名称是否和产品模型定义的服务属性一致
MQTT转发 订阅推送的示意图如下图所示： 推送机制：物联网平台向用户推送Qos0的消息，如果用户未建链或者建链后未订阅Topic，等达到或超过最大缓存时长（最近24H）或最大缓存大小（1GB），物联网平台会滚动清除超期和超出容量限制的数据。 如何进行数据订阅 在物联网平台创建规则
设备远程配置 概述 物联网平台为用户提供远程配置功能，用户可以在不中断设备运行的情况下，远程更新设备的系统参数、运行参数等配置信息。 例如：Windows的收银台机器，需要通过远程配置修改一些系统参数；车联网中的T-BOX，需要通过远程配置修改设备侧的一些数据上报频率等。 业务流程
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
