OneNET Studio 简介 产品介绍 快速入门 设备接入与管理 应用开发
应用开发流程 新建项目 添加设备 设备分组 场景联动 应用数据流转 应用API 应用长连接 规则引擎(新)
运维监控 数据可视化 边缘计算 人工智能AI 位置定位 语音通话 工业互联网标识 权限管理 服务协议 更新日志

文件管理

1. 文件限制

2. 控制台操作

3. 设备文件管理接口

4. 应用文件管理接口


平台提供文件管理功能,支持设备或应用通过HTTP方式,将文件上传至平台服务器存储。用户可对上传文件进行查看、下载等管理操作,同时也可基于存储的图片、文档等信息,进行灵活的业务开发。文件管理两种使用场景:

  • 本地文件存储。设备端通过南向API接口将本地文件上传至平台,平台进行存储,应用对设备上传文件进行管理。

  • 远程文件获取。

    ​ (1)第三发应用通过控制台页面或云端API将文件上传至平台

    ​ (2)第三方应用通过云端API调用物模型服务(结合系统功能点-文件管理类,可用同步或者异步方式,推荐大文件采用异步方式,文件下载结果可通过服务调用记录API查询执行情况),将文件基础信息下发给设备

    ​ (3)设备根据平台下发数据,向平台发起http请求,下载文件。

    ​ (4)文件下载完成之后,向平台回复第二步调用物模型服务的执行状况(命令响应)

1. 文件限制

序号 限制 描述
1 文件大小 单个文件不超过20M,一个账号用户文件不超过1G,滚动式覆盖
2 文件格式 目前仅支持图片和文本。格式:jpg、jpeg、png、bmp、gif、webp、tiff、txt。
3 文件保存时间 单个文件保存最长时间为3个月
4 文件数量 单个设备最多保存1000个文件,滚动式覆盖

2. 控制台操作

进入Studio平台后,展开菜单栏中的「设备接入与管理」,点击「设备管理」,进入设备列表页面。点击「详情」-「文件管理」,如图所示。


图 1 添加设备

操作功能说明:

操作 描述
上传 上传文件到对应设备的文件管理
下载 下载该文件到本地
删除 删除该文件
查看 预览文件

3. 设备文件管理接口

API地址

域名方式:

studio-file.heclouds.com

ip端口方式:

183.230.102.116:27001

鉴权方式

参见设备接入安全鉴权

接口列表

设备端文件管理接口包括文件上传和文件下载。

文件上传
HTTP方法 POST
URL http://{API_ADDRESS}/studio/{pro_id}/{dev_name}/outupload
HTTP头部 Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW Authorization:"version=2018-10-31&res=products/23104&et=1554398783&method=sha1&sign=fsBwuj0udOpU3BLoHmpbFwyIo30="
请求内容 file:file //必填,文件二进制内容
md5=adfadfdafdafdafda //必填,文件的md5,文件完整性校验,确保文件在传输过程中不出错
filename=test.jpa //必填,文件名,下载会时会将该文件名携带在下载报文头部
size=1223 //必填,文件大小,单位:byte
HTTP响应内容 {
"errno": 0,
"error":"succ",
"data": {
“uuid”:”f93fecfedabb47e48631e50d29c89e99”; }
}
备注 errno(Studio-SysFile-Errno):
0: 成功;
1:鉴权失败;
2:请求参数错误;
3:请求参数缺失;
4:文件已存在;
5:文件不存在;
6:请求格式错误;
7:后端服务异常;
8:内部rpc调用异常;
9:存储空间不足;
10:文件大小不一致;
11:文件md5不一致;
12:设备不存在
文件下载
HTTP方法 GET
URL http://{API_ADDRESS}/studio/{productId}/{deviceName}/{uuid}/outdownload
HTTP头部 Content-Type:application/json
Authorization:"version=2018-10-31&res=products/23104&et=1554398783&method=sha1&sign=fsBwuj0udOpU3BLoHmpbFwyIo30="
HTTP响应 二进制文件
备注 Content-Length:当前请求获取的数据大小
Studio-SysFile-Errno:0, //请求的状态

4. 应用文件管理接口

应用端可通过调用云端API进行文件上传,请参见createDeviceFiledeleteDeviceFile(暂不支持)getDeviceFile(暂不支持)

物模型服务调用相关接口,请参见CallService

物模型服务执行记录相关接口,请参考QueryServiceRecord

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “