检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备影子历史数据 典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时,可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID,在物联网平台查询指定设备影子的历史配置数据。 接口描述 1
设备数据变化通知 接口说明 应用服务器在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由
数据采集 物联网平台支持第三方应用查询设备的基本信息,同时还支持查看设备上报的历史数据,能按时、天,月等维度查看设备上报的历史数据。 查询单个设备信息 批量查询设备信息列表 查询设备历史数据 查询设备影子历史数据 查询设备服务能力 父主题: 应用侧Python SDK API参考(联通用户专用)
数据转发规则 规则管理为应用服务器提供物联网平台的规则引擎功能,通过设置规则实现业务的联动变化。 规则引擎包含触发源、条件、动作三部分。规则引擎接收触发源事件,满足规则配置的条件后触发相应动作。 触发源:表示触发规则的事件源,当前支持的触发源有设备数据上报和时间。 条件:表示规则
网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。 appId 可选 String query 设备所属的应用ID,当查询授权应用下设备的服务能力时才需要填写。 deviceId
services[] 设备物模型的属性定义。 表2 services结构体 参数名称 类型 描述 service_id String 设备的服务ID,在设备关联的产品模型中定义。 properties ObjectNode[] 设备按照物模型上报的具体数据。 event_time String
查询设备影子历史数据 典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时,可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID,在物联网平台查询指定设备影子的历史配置数据。 接口描述 1
订阅平台管理数据 典型场景 第三方应用可向物联网平台订阅设备相关的管理数据,当物联网平台中设备进行版本升级等相关操作时,平台会向第三方应用发送通知消息,知会其具体的操作状态或操作结果信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备升级操作通知。 接口功能 支持第三方应
String(1-64) 第三方应用的身份标识,用于唯一标识一个应用。开发者可通过该标识来指定哪个应用来调用物联网平台的开放API。 deviceId String(1-64) 下发命令的设备ID,用于唯一标识一个设备。 command CommandDTOV4 下发命令的信息,具体参见CommandDTOV4结构体。
查询设备命令 典型场景 第三方应用向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况。 接口功能 支持第三方应用在物联网平台查询下发命令的状态和内容信息,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。 接口描述 1 def
String(1-64) 第三方应用的身份标识,用于唯一标识一个应用。开发者可通过该标识来指定哪个应用来调用物联网平台的开放API。 deviceId String(1-64) 下发命令的设备ID,用于唯一标识一个设备。 command CommandDTOV4 下发命令的信息,具体参见CommandDTOV4结构体。
query 命令所属的应用ID,当创建授权应用下的命令时才需要填写。 deviceId 必选 String(64) body 下发命令的设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 command 必选 CommandDTO body 下发命令的信息。 callbackUrl
deviceCommandId 必选 String path 要修改的命令ID,在调用创建设备命令接口后获得。 appId 可选 String query 命令所属的应用ID,当修改授权应用下的命令时才需要填写。 status 必选 String body 命令的状态,可选值:CANCELED,撤销命令。
设备数据变化通知 接口说明 应用服务器在物联网平台订阅了设备属性变化通知后(订阅的资源为device.data,事件为update),当设备上属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI
gatewayId为设备所关联的直连设备(即网关)的deviceId。 appId String(256) 设备所属的应用ID。 desired JsonObject 要向设备下发的配置信息。 timestamp String(256) 数据配置的UTC时间,时间格式:yyyyM
订阅平台管理数据 典型场景 第三方应用可向物联网平台订阅设备相关的管理数据,当物联网平台中设备进行版本升级等相关操作时,平台会向第三方应用发送通知消息,知会其具体的操作状态或操作结果信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备升级操作通知。 接口功能 支持第三方应
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据,以及设备支持下发哪些命令,可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 Q
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据,以及设备支持下发哪些命令,可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 def
设备数据批量变化通知 接口说明 应用服务器在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST
接收到平台推送的消息后,开发者需要根据业务进行处理,但不建议进行复杂计算、I/O操作或者可能长时间等待的动作,可以先写数据库,应用进入相应界面或者刷新界面再从数据库取数据并进行数据处理。 回调路径已在SDK中设置好了,所以在订阅时要注意设置对应的回调地址。回调的IP地址则是服务器的地址,