IoT File Service¶
构想¶
IoT File Service 为用户提供用于 assets 相关文件的文件管理功能。该服务提供一个接口用于管理数据、搜索文件以及将文件下载到指定的代理。也可以将文件上传到临时存储区域进行管理。
访问¶
要访问此服务,您需要具有 IoT File Service 角色和范围中列出的相应角色。
用户只能与其租户和子租户中的文件进行交互。
基础知识¶
该服务可以实现 CRUD(创建、读取、更新和删除)功能以及文件搜索功能。
每个文件都链接到一个 asset。一个 asset 可以附加多个文件。每个请求都需要提供 asset ID。
每个文件都有一组由标准属性组成的元数据:
- 文件 ID
- 文件名
- 文件路径(文件在 MindSphere 中的位置)
- 文件类型(例如,图像)
- 文件大小
- 描述
- 时间戳(创建和更新)
MindSphere 不会解析这些文件的内容,您需要使用自定义应用或分析工具来解读和可视化数据。
可以存储或检索的最大请求有效载荷取决于客户端的网络速度。当前超时设置为一分钟,如果读取或写入文件的操作超过一分钟将导致错误 502 "Bad Gateway"。 如果文件太大而无法在一分钟内完成上传,请使用分块上传功能。
版本控制¶
该服务不提供显式版本控制。如果需要存储文件的不同版本,请在文件名中添加版本标识符以确保其唯一性。
文件删除¶
始终以物理方式删除文件。不提供逻辑删除功能。如果以物理方式删除 asset,则会自动删除 asset 中的文件。
文件搜索¶
可以通过过滤和排序操作查询文件。有关详细信息,请参见过滤文档。
功能¶
IoT File Service 公开其 API 以实现以下任务:
- 创建一个新的文件
- 更新(覆盖)现有文件
- 读取文件
- 删除文件
- 按元数据搜索文件
- 按元数据对文件进行计数和排序
- 分块上传和下载
限制¶
所有请求都要通过 MindSphere 网关,并且必须满足 MindSphere 网关限制的相关要求。
要获取最新的限制列表,请转至版本说明,并选择最新日期。再转至“MindAccess Developer Plan 订户和 MindAccess Operator Plan 订户”,选择您感兴趣的 IoT 服务。
示例场景¶
某啤酒厂的应用开发者想要存储与 assets 相关联的文件,以便提供附加的元信息(例如,图像、技术描述、手册等)。
开发者使用 IoT File Service 将文件上传到 asset。