检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备服务能力变化通知 接口说明 应用服务器在物联网平台订阅了设备服务能力变化通知后(订阅的通知类型为deviceCapabilitiesChanged),在物联网平台上设备Profile文件中的服务和属性被修改时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
创建批量任务 典型场景 第三方应用若需要对多个设备进行批量操作时,可调用此接口创建设备的批量操作任务,当前仅支持给批量设备下发缓存命令。 接口功能 支持第三方应用在物联网平台创建设备的批量操作任务。 接口描述 1 BatchTaskCreateOutDTO createBatch
增加设备组成员 典型场景 若需要把新增的设备或已有设备增加到某个设备组中,第三方应用可调用此接口向指定设备组添加设备成员。在向设备组添加设备前,建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制,确保设备组中还有足够的可添加成员数量。 接口功能 支持第三方应用在物联网平台向指定设备组添加设备。
订阅平台业务数据 典型场景 第三方应用可在物联网平台订阅设备相关的业务数据,当物联网平台中设备的业务信息发生变化时(如设备注册、设备数据上报、设备状态变更等),平台会向第三方应用发送通知消息,通知其具体的变化信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备业务变更通知。
设备服务能力删除通知 接口说明 应用服务器在物联网平台订阅了设备服务能力删除通知后(订阅的通知类型为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} 传输协议
删除指定版本包 接口说明 对于不需要继续使用和保留的设备版本包,应用服务器可调用此接口在物联网平台上删除指定的版本包,可根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除的版本包ID。 URI 请求方法 DELETE URI /iodm/northbound/v1
订阅平台管理数据 典型场景 第三方应用可向物联网平台订阅设备相关的管理数据,当物联网平台中设备进行版本升级等相关操作时,平台会向第三方应用发送通知消息,知会其具体的操作状态或操作结果信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备升级操作通知。 接口功能 支持第三方应
修改设备信息 典型场景 第三方应用在物联网平台注册设备后,若设备的基本信息发生变更,也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息,包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 def modifyDeviceInfo(self
设备影子(联通用户专用) 非联通用户请查看设备接入服务。 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件,用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子,设备可以获取和设置设备影子以此来同步设备属性
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken。
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken。
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。应用服务器可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。
修订记录 发布日期 修订记录 2019-05-28 第三次正式发布 新增 设备侧MQTT接口参考 2019-05-13 第二次正式发布 修改 查询设备历史数据,删除serviceId和property可选参数。 2018-12-20 第一次正式发布 新增 应用侧API参考
设备接收命令 接口说明 设备接收物联网平台下发的控制命令。 Topic Topic /huawei/v1/devices/{deviceId}/command/{codecMode} 消息发送方 物联网平台 消息接收方 设备 参数说明 参数 必选/可选 类型 描述 msgType
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组,第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 def deleteDevicesFromGroup(self, dgwdlDTO, accessAppId
增加设备组成员 典型场景 若需要把新增的设备或已有设备增加到某个设备组中,第三方应用可调用此接口向指定设备组添加设备成员。在向设备组添加设备前,建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制,确保设备组中还有足够的可添加成员数量。 接口功能 支持第三方应用在物联网平台向指定设备组添加设备。
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。