检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备消息上报 功能描述 是指设备无法按照产品模型中定义的属性格式进行数据上报时,可调用此接口将设备的自定义数据格式上报给平台,平台对该消息不进行解析,该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别,请查看消息通信说明。 低配置且资源受限或
设备上报升级状态 功能介绍 设备上报升级状态。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释: 网关设备上报时,子设备进
设备时间同步响应 功能描述 平台向设备发送时间同步响应,携带设备发送时间device_send_time。当平台收到时间server_recv_time 后,向设备发送时间server_send_time 。 例如,设备收到的设备侧时间为device_recv_time ,则设备计算自己的准确时间为:
创建资源空间 功能介绍 资源空间对应的是物联网平台原有的应用,在物联网平台的含义与应用一致,只是变更了名称。应用服务器可以调用此接口创建资源空间。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/apps 表1 路径参数 参数 是否必选
查询资源空间 功能介绍 资源空间对应的是物联网平台原有的应用,在物联网平台的含义与应用一致,只是变更了名称。应用服务器可以调用此接口查询指定资源空间详情。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/apps/{app_id} 表1
添加设备组 功能介绍 应用服务器可调用此接口新建设备组,一个华为云账号下最多可有1,000个设备组,包括父设备组和子设备组。设备组的最大层级关系不超过5层,即群组形成的关系树最大深度不超过5。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group
平台设置设备属性 功能介绍 用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性,平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后,需要将执行结果返回给平台,如果设备没回响应平台会认为属性设置请求执行超时。 低配置且资源受限或者对网络流量有
设备属性上报 接口说明 用于设备按产品模型中定义的格式将属性数据上报给平台。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/properties/report 传输协议 HTTPS 请求参数 名称 必选 类型 位置 说明 access_token
平台命令下发 功能介绍 用于平台向设备下发设备控制命令。平台下发命令后,需要设备及时将命令的执行结果返回给平台,如果设备没回响应,平台会认为命令执行超时。命令下发和消息下发的区别,请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网
平台查询设备属性 功能介绍 用于平台向设备查询属性信息。平台可调用查询设备属性接口查询设备的属性数据。设备收到属性查询请求后,需要将设备的属性数据返回给平台,如果设备没回响应平台会认为属性查询请求执行超时。 低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与
开发前必读 方案概述 基于IoT平台实现一个物联网解决方案,需要完成以下操作: 开发操作 开发说明 产品开发 主要呈现物联网平台的界面查询与操作,包括产品管理、产品模型开发、插件开发、在线调试等。 应用开发 主要为业务应用与物联网平台的集成对接开发,包括API接口调用、业务数据获取和HTTPS证书管理。
创建设备 功能介绍 应用服务器可调用此接口在物联网平台创建一个设备,仅在创建后设备才可以接入物联网平台。 该接口支持使用gateway_id参数指定在父设备下创建一个子设备,并且支持多级子设备,当前最大支持二级子设备。 该接口同时还支持对设备进行初始配置,接口会读取创建设备请求参
物模型相关问题 本文介绍物模型相关的问题和解决方法。 如何进行产品模型开发? 物联网平台提供线上和线下两种产品模型开发方式:线上开发指导详见线上开发参考;线下开发指导详见线下开发参考。 在线开发产品模型时,如何选择数据类型? 数据类型的配置可以参考如下原则: int:当上报的数据
创建批量任务 功能介绍 应用服务器可调用此接口为创建批量处理任务,对多个设备进行批量操作。当前支持批量软固件升级、批量创建设备、批量修改设备、批量删除设备、批量冻结设备、批量解冻设备、批量创建命令、批量创建消息任务。 调用方法 请参见如何调用API。 URI POST /v5/i
应用快速接入 为了降低应用侧的开发难度、提升应用侧开发效率,物联网平台向应用侧开放了丰富的API。本文档以在线调试(即API Explorer)和本地调试(Postman)为例,模拟应用服务器以HTTPS协议为例接入物联网平台。 在线调试(推荐) API Explorer提供在线
企业版实例特殊管理 修改企业版实例信息 IoTDA企业版实例创建成功后,您可以根据自己的业务情况对IoTDA企业版实例的部分参数进行调整,包括实例名称、描述等信息。 访问设备接入服务,单击“管理控制台”进入设备接入控制台。 选择左侧导航栏“IoTDA实例”,单击企业版实例对应的“详情”进入实例详情页面。
API使用指导 为了降低应用侧的开发难度、提升应用侧开发效率,物联网平台向应用侧开放了API(Application Programming Interface)。您可以调用开放的API,快速集成物联网平台的功能,如产品管理、设备管理、订阅管理、设备命令、规则管理等功能。 应用侧
API概览 调用以下接口前,请先参考认证鉴权完成认证鉴权操作。 产品管理 API 说明 查询产品列表 查询已导入物联网平台的产品模型信息列表,了解产品模型的概要信息。 创建产品 创建产品。此接口仅创建了产品,没有创建和安装插件,如果需要对数据进行编解码,还需要在平台开发和安装插件。
构造请求 本节介绍REST API请求的组成,并以调用物联网平台的查询产品和创建产品接口说明如何调用API,该API可用于获取用户的指定产品信息。 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path}
设备属性上报 概述 属性上报是一种需要平台解析、缓存,通过数据流转功能将数据转发到应用侧或华为云其他云服务的一种方式。需要在平台建立产品模型。对于属性上报的数据,平台会记录属性的最新一次上报值,对符合产品模型定义的属性数据进行存储。设备可以通过设备侧获取平台的设备影子数据向平台获取最新的设备属性值。