检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken
订阅平台管理数据 接口说明 应用服务器可调用此接口向物联网平台订阅设备相关的管理数据,当设备进行版本升级等相关操作时,平台会向应用服务器发送通知消息,知会其具体的操作状态或操作结果信息。 URI 请求方法 POST URI /iodm/app/sub/v1.1.0/subscribe
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:平台收到命令后缓存起来
查询设备历史数据 接口说明 在日常运行中,物联网平台会收到并保存设备上报业务数据,应用服务器若需要查看某个设备上报到平台的历史数据,可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/data/v1.2.0/deviceDataHistory 传输协议 HTTPS
设备快速接入(联通用户专用) 非联通用户请查看设备接入服务。 本文档以MQTT.fx为例,介绍以MQTT原生协议接入物联网平台。MQTT.fx是目前主流的MQTT客户端,可以快速验证是否可以与物联网平台服务交互发布或订阅消息。 前提条件 已经注册华为云官方帐号,可点击注册页面完成注册
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。应用服务器可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台
删除设备组 典型场景 若因分组变更,第三方应用不再需要使用某个设备组,且不想在物联网平台上继续保存该设备组信息时,可调用此接口在物联网平台删除指定设备组。 接口功能 支持第三方应用在物联网平台根据设备组ID删除指定设备组。 接口描述 1 void deleteDeviceGroup
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组,第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 def deleteDevicesFromGroup(self, dgwdlDTO, accessAppId
修改设备组 接口说明 若因业务变更需要修改设备组的信息,如设备组名称、设备组的设备数量限制等,应用服务器可调用此接口修改指定设备组的信息。 URI 请求方法 PUT URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议
删除子设备 若子设备不再需要接入物联网平台,应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现,具体删除子设备命令需网关提前实现(即网关收到什么命令会触发删除子设备的流程),并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时
查询指定设备组 接口说明 应用服务器若需要查看某个设备组的信息,以了解该设备组的使用情况,可调用此接口查询指定设备组的信息。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议 HTTPS 请求参数
创建批量任务 典型场景 第三方应用若需要对多个设备进行批量操作时,可调用此接口创建设备的批量操作任务,当前仅支持给批量设备下发缓存命令。 接口功能 支持第三方应用在物联网平台创建设备的批量操作任务。 接口描述 1 BatchTaskCreateOutDTO createBatchTask
增加设备组成员 典型场景 若需要把新增的设备或已有设备增加到某个设备组中,第三方应用可调用此接口向指定设备组添加设备成员。在向设备组添加设备前,建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制,确保设备组中还有足够的可添加成员数量。 接口功能 支持第三方应用在物联网平台向指定设备组添加设备
增加设备组成员 典型场景 若需要把新增的设备或已有设备增加到某个设备组中,第三方应用可调用此接口向指定设备组添加设备成员。在向设备组添加设备前,建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制,确保设备组中还有足够的可添加成员数量。 接口功能 支持第三方应用在物联网平台向指定设备组添加设备
订阅平台业务数据 典型场景 第三方应用可在物联网平台订阅设备相关的业务数据,当物联网平台中设备的业务信息发生变化时(如设备注册、设备数据上报、设备状态变更等),平台会向第三方应用发送通知消息,通知其具体的变化信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备业务变更通知。
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅
设备服务能力删除通知 接口说明 应用服务器在物联网平台订阅了设备服务能力删除通知后(订阅的通知类型为deviceCapabilitiesDeleted),在物联网平台上删除设备Profile文件时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI
删除设备 接口功能 当有新设备需要从网关移除时,通过调用设备删除接口将非直连设备从物联网平台删除。 接口描述 1 HW_INT IOTA_HubDeviceRemove(HW_UINT uiCookie, const HW_CHAR *pcDeviceId); 参数说明 字段 必选
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时,可调用此接口删除指定的订阅配置,取消订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId} 传输协议