检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询任务列表 接口说明 应用服务器可调用此接口查询已创建的升级任务列表信息,以了解当前已有的升级任务信息及各个任务的执行情况,可根据条件查询满足要求的升级任务信息。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/operations 传输协议 HTTPS
查询设备命令 接口说明 应用服务器向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommands
查询设备命令撤销任务 接口说明 应用服务器创建了设备命令撤销任务后,可调用此接口查询设备命令撤销任务的详细信息和执行状态,以了解撤销任务的执行情况,可指定条件查询单个或多个撤销任务。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommandCancelTasks
设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 select 可选 String query 指定查询条件,可选值:“imsi”。 appId 可选 String query 如果是本应用的设备,此参数值可以填写None,否则填写授权应用的appId。 accessToken
类都包含了main方法,可单独运行,旨在演示如何调用SDK接口。 开发环境要求 开发平台 开发环境 配套要求 推荐的操作系统 IoT 开发工具:JetBrains PyCharm 2018.1.4 x64 Python Project Interpreter:Python 3.7或Anaconda
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(PENDING状态),此时应用服务器可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
查询指定任务的子任务详情 接口说明 在创建了设备软件升级任务或固件升级任务后,任务中涉及的每个设备的升级是一个子任务(即升级任务中涉及多少个设备,就有多少个子任务)。应用服务器可调用此接口查询某个升级任务中各个子任务的详细信息,以查看子任务的具体执行情况。 URI 请求方法 GET
规则事件通知 接口说明 应用服务器在物联网平台订阅了规则事件通知后(订阅的通知类型为ruleEvent),当平台中配置的规则触发时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
体验开发中心(联通用户专用) 非联通用户请查看设备接入服务。 本文通过“智慧路灯”为示例,通过开发中心提供的设备模拟器和应用模拟器替代真实的设备和应用,带您快速体验设备上报数据到物联网平台和远程下发控制命令到设备的全过程。 假设: 路灯设备上报一条数据消息,包含路灯的光照强度(L
设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 select 可选 String query 指定查询条件,可选值:imsi。 appId 必选 String query 如果是本应用的设备,此参数值可以填写null,否则填写授权应用的appId。 accessToken
ASC:按注册设备的时间升序排列 DESC:按注册设备的时间降序排列 缺省值:DESC。 select 可选 String query 指定返回记录,可取值:imsi。 响应参数 QueryBatchDevicesInfoOutDTO 参数 类型 描述 totalCount long 查询的记录数量。
“ASC”:按注册设备的时间升序排列 “DESC”:按注册设备的时间降序排列 缺省值:“DESC”。 select 可选 String query 指定返回记录,可取值:“imsi”。 响应参数 QueryBatchDevicesInfoOutDTO 参数 类型 描述 totalCount long 查询的记录数量。
查询设备影子历史数据 接口说明 应用服务器通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当应用服务器需要查看设备影子的历史配置记录时,可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/shadow/v1.5.0/deviceDesiredHistory
上报设备数据 接口功能 当直连设备(网关)有数据需要上报或者非直连设备上报数据到网关时,网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的deviceId,requstId和serviceId由SDK组装为消息的header;servicePropert
查询设备历史数据 接口说明 在日常运行中,物联网平台会收到并保存设备上报业务数据,应用服务器若需要查看某个设备上报到平台的历史数据,可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/data/v1.2.0/deviceDataHistory 传输协议 HTTPS
上报设备数据 接口功能 当直连设备(网关)有数据需要上报或者非直连设备上报数据到网关时,网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的deviceId,requstId和serviceId由SDK组装为消息的header;servicePropert
String(1~256) body 设备所在时区信息,使用时区编码,如上海时区对应的时区编码为Asia/Shanghai。 imsi 可选 String(1-64) Body NB-IoT终端的IMSI。 ip 可选 String(128) Body 设备的IP地址。 isSecure 可选 Boolean
鉴权 接口说明 应用服务器首次访问物联网平台的开放API时,需调用此接口完成认证鉴权,获取accessToken。 注意事项 鉴权接口是调用其他API的前提,除了调用鉴权接口,其他接口调用都需要在request header中携带参数app_key和Authorization。a
String(256) Body 终端用户ID。 在NB-IoT方案中,endUserId设置为设备的IMSI号。 imsi 可选 String(1-64) Body NB-IoT终端的IMSI。 isSecure 可选 Boolean Body 指定设备是否为安全设备,默认值为fals