检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 非联通用户请查看设备接入服务。 概述 物联网平台把自身丰富的管理能力通过API的形式对外开放,包括设备管理、数据采集、命令下发、设备升级等,帮助用户快速构筑基于物联网平台的行业应用。您可以根据本文档提供的API来使用物联网平台的服务,平台支持的全部API请参见API列表。 调用说明
计费详情(联通用户专用) 非联通用户请查看设备接入服务。 计费变更 设备管理服务和设备接入服务已经整合为全新升级的设备接入服务(IoT Device Access),设备管理服务不另外收费。 原设备管理服务已开通使用的用户(必须同时使用设备接入服务),业务使用不受影响, 自202
每小时 引导激活设备统计 统计通过“设备引导服务”方式注册并激活的设备数。 5分钟 软件升级状态 统计当前应用下,历史上所有设备的软件升级任务,执行成功和失败的设备数量。 实时 固件升级状态 统计当前应用下,历史上所有设备的固件升级任务,执行成功和失败的设备数量。 实时 设备配置状态
远程维护操作包括设备的运行日志收集、重启模组。 固件升级 用户可以通过OTA的方式对支持LWM2M协议的设备进行固件升级,升级协议为LWM2M协议。 软件升级 用户可以通过OTA的方式支持对LWM2M协议的设备进行软件升级,升级协议为PCP协议。 网关与子设备 物联网平台支持设备
swUpgradeStateChangeNotify(软件升级状态变更通知) swUpgradeResultNotify(软件升级结果通知) fwUpgradeStateChangeNotify(固件升级状态变更通知) fwUpgradeResultNotify(固件升级结果通知) callbackUrl
在对设备进行某些操作时(如升级设备软固件、批量下发命令等),可通过设备组来指定要进行操作的设备。 设备升级 若需要对设备进行软固件版本升级,应用服务器可调用本部分接口为多个设备创建升级任务,升级前请确保目标版本包已经上传到物联网平台。当前仅支持对CoAP接入的设备进行软固件版本升级。 父主题:
第三方应用可调用此接口在物联网平台上创建设备组,并把设备归类到不同的设备组内,进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时(如升级设备软固件、批量下发命令等),可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组,用于对设备进行分组管理。
第三方应用可调用此接口在物联网平台上创建设备组,并把设备归类到不同的设备组内,进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时(如升级设备软固件、批量下发命令等),可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组,用于对设备进行分组管理。
测试环境的设备/应用要迁移商用环境,需要在商用环境重新创建应用和注册设备,并修改设备/应用中平台的接入信息。 两者的设备数量限制不一样 开发中心单个项目(应用)下最多可注册20个设备,设备管理服务单个应用下最多可注册1000万个设备。在其他的平台能力上,两者保持一致,例如开发中心
注册LoRa网关 接口说明 loraServer网关上线后,注册LoRa网关。 注意事项 应用已鉴权,在header中携带参数app_key和Authorization: Bearer {accessToken} URI 请求方法 POST URI /api/v3.0/devices/lora/gateway
注册设备通知 典型场景 第三方应用在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当第三方应用通过“注册直连设备”接口在平台注册设备时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了注册设备通知的第三方应用推送通知消息。 注意事项 1
注册设备通知 典型场景 第三方应用在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当第三方应用通过“注册直连设备”接口在平台注册设备时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了注册设备通知的第三方应用推送通知消息。 注意事项
通过接口在平台注册设备,为什么一段时间后注册设备会被平台删除? 通过调用接口注册设备时,需要填写“timeout”参数。注册完成后,如果在“timeout”参数设定的时间内,设备还未和物联网平台绑定,则该注册设备将会被物联网平台删除。 “timeout”取值范围为0~214748
swUpgradeStateChangeNotify(软件升级状态变更通知) swUpgradeResultNotify(软件升级结果通知) fwUpgradeStateChangeNotify(固件升级状态变更通知) fwUpgradeResultNotify(固件升级结果通知) pageNo 可选 Integer
成功。 单个设备注册 物联网平台支持通过应用服务器调用“注册设备(验证码方式)”/“注册设备(密码方式)”接口、或者在控制台上进行单个设备注册。控制台上注册方式如下: 登录物联网平台控制台,点击右上角“进入设备管理服务”。 单击左下角,选择“ 设备 > 设备注册”。 选择页签“单
支持通过OTA(Over the Air)的方式,对终端设备进行软件、硬件的升级操作,并通过软固件升级策略管理(群组、升级时间、并发数控制等),有效提升升级灵活性。详细请参见固件升级、软件升级。 报表统计 在控制台上提供了丰富的报表功能,方便用户查看应用和设备的使用情况。详细请参见设备监控。
地址对应的服务端端口没有开放。请在其他外网机器上使用telnet命令验证下您的IP和端口是否已开放。若未开放,请修改订阅的IP和端口。 如果订阅地址是域名,并且域名绑定多个IP,需要做好DNS解析,确保DNS解析后的IP地址可达。 如果订阅地址是HTTPS地址,还有可能是服务端的证书制作有问题或者
开通设备管理服务时,系统会同时开通设备接入服务。开通设备管理服务后,设备接入服务中已注册的设备,可以在设备管理服务中继续使用。 设备管理 在设备接入基础上,增加了产品模型定义、远程诊断、数据存储、软固件升级等更丰富的设备管理能力。使用设备管理时,包含设备接入服务的能力。 商用环境 按照设备数收费
注册LoRa节点 接口说明 loraServer网关上线后,注册LoRa节点。 注意事项 应用已鉴权,在header中携带参数app_key和Authorization: Bearer {accessToken} URI 请求方法 POST URI /api/v3.0/devices/lora/node
订阅平台业务数据 接口说明 应用服务器可调用此接口在物联网平台订阅设备相关的业务信息,当设备的业务信息发生变化时(如设备注册、设备数据上报、设备状态变更等),平台会向应用服务器发送通知消息。 URI 请求方法 POST URI /iocm/app/sub/v1.2.0/subscriptions