检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何获取证书? 请按照以下途径获取: 设备侧Agent Lite的证书 应用服务器加载的平台证书 应用服务器订阅平台数据时,制作调测证书或购买证书。 父主题: 应用集成(联通用户专用)
query 设备所属的应用ID,当删除授权应用下的设备时才需要填写。 cascade 可选 Boolean query 仅当设备下连接了非直连设备时生效。默认值为true。 true,级联删除,即删除直连设备和其下的非直连设备。 false,删除直连设备,但是不删其下的非直连设备,并将非直连设备的属性变为直连设备属性。
修改设备组 接口说明 若因业务变更需要修改设备组的信息,如设备组名称、设备组的设备数量限制等,应用服务器可调用此接口修改指定设备组的信息。 URI 请求方法 PUT URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议
接口说明 应用服务器在物联网平台订阅了设备激活通知后(订阅的资源为device,事件为activate),当设备首次接入物联网平台并激活时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备激活通知中的callbackUrl决定
port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考物联网平台API参考中的消息推送章节。
钟),然后通过轮询的方式向各个推送失败的应用服务器进行推送重试,缓存时间超时后如果还未推送成功,物联网平台不再进行推送重试。在消息缓存时间内,物联网平台重试推送失败的次数达到10次后,会将该推送的URL地址设置为无效,并按照轮询的方式,轮询探测所有失败URL的有效性,如果恢复,则
获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 可选 String Header 实例ID。物理多租下各实例的唯一标识,一般华为云租户无需携带该参
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后(资源为device.status,事件为update),当物联网平台中的设备状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法
212Z。 若需要显示本地时区时间,您需要自己进行时间转换。 lastModifiedTime String(256) 最后修改设备的UTC时间,时间格式:yyyyMMdd'T'HHmmss'Z',如20151212T121212Z。 若需要显示本地时区时间,您需要自己进行时间转换。
query 设备所属的应用ID,当查询授权应用下的设备信息时才需要填写。 gatewayId 可选 String query 网关ID,用于标识一个网关设备。当设备是直连设备时,gatewayId与设备的deviceId一致。当设备是非直连设备时,gatewayId为设备所关联的直连设备(即网关)的deviceId。
appId 必选 String(64) body 批量任务所属的应用ID,当创建授权应用下的批量任务时才需要填写。 param 必选 ObjectNode body 任务详细参数,根据taskType任务类型的不同对应不同类型参数。 taskName 必选 String body
分页查询参数,查询结果分页显示时每页显示的记录数,默认1,最大值2000,建议根据设备上报数据的平均大小来设置,保证单次查询返回的包大小不超过16Mb,同时根据单次查询返回的包大小以及网络带宽设置合理的超时时间。 startTime 可选 String query 查询产生时间在startTime之后的历史数据
刷新token 接口说明 应用服务器通过鉴权接口获取到的accessToken是有效时间的,在accessToken快过期时,应用服务器通过调用此接口,获取新的accessToken。 URI 请求方法 POST URI /iocm/app/sec/v1.1.0/refreshToken
login(); 然后等待Agent Lite的连接状态广播。 建议: 在连接成功的处理函数中进行非直连设备状态上报的处理,并且将缓存的上报数据进行上报。 在连接断开的处理函数中记录设备断开状态,之后如果有非直连设备上报数据,需要进行缓存,等到连接成功后再进行上报。 1 2
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作,上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口,对应参数配置为EN_IOTA_CFG_IOCM_ADDR和EN_IOTA_CFG_IOCM_PORT。
订阅平台业务数据 接口说明 应用服务器可调用此接口在物联网平台订阅设备相关的业务信息,当设备的业务信息发生变化时(如设备注册、设备数据上报、设备状态变更等),平台会向应用服务器发送通知消息。 URI 请求方法 POST URI /iocm/app/sub/v1.2.0/subscriptions
可查询绑定在该应用下的设备与物联网平台进行数据对接的不同协议所对应的端口信息。 可查询绑定在该应用上的应用服务器与物联网平台进行数据对接的端口信息。 应用和设备接入的域名和接口信息,请在设备接入服务的控制台上获取。 消息推送 推送协议是由应用服务器在订阅物联网平台的设备信息时设置的传输协议来
删除指定版本包 接口说明 对于不需要继续使用和保留的设备版本包,应用服务器可调用此接口在物联网平台上删除指定的版本包,可根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除的版本包ID。 URI 请求方法 DELETE URI /iodm/northbound/v1
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(PENDING状态),此时应用服务器可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
订阅平台管理数据 接口说明 应用服务器可调用此接口向物联网平台订阅设备相关的管理数据,当设备进行版本升级等相关操作时,平台会向应用服务器发送通知消息,知会其具体的操作状态或操作结果信息。 URI 请求方法 POST URI /iodm/app/sub/v1.1.0/subscribe