检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备侧对接 定义产品 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。 在左侧导航栏选择“产品”，单击左侧“创建产品”。 图1 创建产品-HJ212 单击“更多-详情”进入产品详情页面，单击“基本信息”中“上传模型文件”，导入hj212_product_model
AuthInfo object 参数说明：设备的接入认证信息。 product_id 否 String 参数说明：设备关联的产品ID，用于唯一标识一个产品模型。 product_name 否 String 参数说明：设备关联的产品名称。 status 否 String 参数说明：设备的状态。
参数说明：设备标识码，通常使用IMEI、MAC地址或Serial No作为nodeId。 最大长度：256 product_id 否 String 参数说明：产品ID，用于唯一标识一个产品，在注册产品时由物联网平台分配获得。 最大长度：256 gateway_id 否 String 参数说明：
参数说明：项目ID。获取方法请参见 获取项目ID 。 表2 Query参数 参数 是否必选 参数类型 描述 product_id 否 String 参数说明：设备关联的产品ID，用于唯一标识一个产品模型，创建产品后获得。方法请参见 创建产品。 取值范围：长度不超过36，只允许字母、数字、下划线（_）、连接符（-）的组合。
fx安装请参考使用MQTT.fx调测。 升级包文件准备。固件升级包及其版本号需向模组厂家获取。本次演示使用临时文件代替。 创建产品，创建MQTT协议产品（如果有MQTT协议产品可直接使用）。 注册单个设备。 设备群组，将注册的设备加入一个设备群组(创建升级任务时会用到)。 上传升级包 访问设
AuthInfo object 参数说明：设备的接入认证信息。 product_id 否 String 参数说明：设备关联的产品ID，用于唯一标识一个产品模型。 product_name 否 String 参数说明：设备关联的产品名称。 status 否 String 参数说明：设备的状态。
内的所有资源，如设备、产品、订阅数据在平台中的信息会被全部删除，并且不可恢复，请谨慎操作。 创建资源空间 用户首次开通设备接入服务时，物联网平台自动为用户创建了一个默认资源空间，“默认资源空间”每个实例仅有一个，不允许删除。 您可以基于默认资源空间创建产品，注册设备等，也可以参考如下步骤创建新的资源空间。
据到物联网平台： 设备消息上报：设备无法按照产品模型中定义的属性格式进行数据上报时，将设备的自定义数据通过设备消息上报接口上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 设备属性上报：用于设备按产品模型中定义的格式将属性数据上报给平台。 网关
service_id String 设备的服务ID，在设备关联的产品模型中定义。 desired DeviceShadowProperties object 用户最近一次对设备下发的预期数据，Json格式，里面是一个个键值对，每个键都是产品模型中属性的参数名(property_name)。 reported
该场景主要描述的是设备可以通过MQTT协议与物联网平台进行交互，用户可以在控制台产品详情中自定义Topic，通过应用侧接口或控制台创建数据转发规则，把设备上报的消息转发给其他华为云服务，供应用侧用户主动去消费。 核心知识点：产品模型、消息上报、消息下发、MQTT协议、数据转发规则、自定义Topic。
用户可以调用此接口创建一个设备接入实例。支持的实例规格请参见产品规格说明。 接口约束： 请保证账户余额充足，此接口无法使用优惠券支付，在创建包年/包月实例时，若余额不足会创建一个待支付订单。 若想使用优惠券，请将请求中的is_auto_pay字段设置为false，参考支付包年/包月产品订单进行支付，或者在华为云官网页面使用优惠券进行支付。
事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 paras 必选 Object 参数解释： 设备服务的事件列表，具体字段在设备关联的产品模型中定义。 paras参数列表 字段名 必选/可选 类型 参数描述 switch 可选 String 参数解释： 设备侧日志收集开关。 取值范围：
自定义模型（在线开发）：支持在线构建产品模型。 上传模型文件（离线开发）：支持将本地写好的产品模型上传到物联网平台。 导入产品模型：支持产品模型的导入和导出。 支持区域： 全部 什么是产品模型 在线开发产品模型 离线开发产品模型 导入和导出产品模型 设备数据订阅流转 支持通过API或控制台订阅
service_id 否 String 参数说明：设备命令所属的设备服务ID，在设备关联的产品模型中定义。 取值范围：长度不超过64的字符串。 command_name 否 String 参数说明：设备命令名称，在设备关联的产品模型中定义。 取值范围：长度不超过128的字符串。 paras 是 Object
修改设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备，并将设备执行属性结果同步返回。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。 paras 必选 Object 参数解释： 设备服务的事件列表，具体字段在设备关联的产品模型中定义。 paras参数列表 字段名 必选/可选 类型 参数描述 timestamp 可选 String 参数解释： 日志产生时间。 type
quickStart(C#) quickStart(Node.js) 产品模型模板 产品模型模板中包含了典型场景的产品模型样例，开发者可以在模板基础进行修改，定义自己需要的产品模型。 使用指导可以参考离线开发产品模型。 产品模型开发示例 编解码插件样例 编解码插件的代码样例工程，开发者可以基于该样例工程进行二次开发。
图5 设备迁移任务详情页高级搜索 当同步任务类型为“指定设备同步”时，此类任务下所有同步设备均属于同一应用、同一产品。因此在进行同步设备列表的“高级搜索”时，搜索项“所属产品”和“所属资源空间”均为空。 在设备同步详情页，可以查看单个设备的信息和设备的发放记录。 图6 设备迁移任务详情页
下发执行超时。 使用场景 用于平台主动获取或修改设备属性值。 平台规范、解析、过滤的数据。 使用限制 单个消息内容不大于64K。 需要定义产品模型。 相关API接口 平台设置设备属性 平台查询设备属性 属性下发使用说明 属性下发分为修改属性与获取属性值，下列以修改属性为例，介绍属性下发。
status：update（设备消息状态变更） batchtask：update （批量任务状态变更） product：create（产品添加） product：delete（产品删除） product：update（产品更新） device.command.status：update（设备异步命令状态更新）
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
