Skip to content

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。

相关链接

还有问题?

向社区提问


除非另行声明,该网站内容遵循MindSphere开发许可协议.


Last update: July 11, 2019