查询数据资产

按原始文件 ID 查询其处理后对应的数据资产。

GET https://moi.matrixorigin.cn/newmoi/catalog/files/{file_id}/data-asset

调用前准备

先查询文件列表取得原始文件 ID。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和文件 ID。

下方示例使用：

• $AI_STUDIO_API_KEY：实际个人访问令牌，通过 X-API-Key Header 传递。

• $WORKSPACE_ID：目标工作区 ID，通过 X-Workspace-ID Header 传递。

• $FILE_ID：要查询数据资产的原始文件 ID。

路径参数

参数	类型	说明
file_id	string	原始文件 ID。

请求示例

curl "https://moi.matrixorigin.cn/newmoi/catalog/files/$FILE_ID/data-asset" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

成功响应

成功时返回 200 和数据资产信息。文件尚未处理为数据资产时返回 404，接口不会自动创建数据资产。

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "asset": {
      "id": 1,
      "asset_id": "asset-123",
      "name": "orders.csv",
      "volume_id": 789,
      "asset_type": "file",
      "asset_ref": "file-123"
    },
    "derivations": [],
    "assets_by_id": {}
  }
}

响应字段如下。

字段	类型	说明
code	string	成功时为 OK。
msg	string	成功时为 OK。
data.asset	object	与原始文件对应的数据资产。
data.asset.id	integer	数据资产内部 ID。
data.asset.asset_id	string	数据资产 ID。
data.asset.name	string	资产名称。
data.asset.volume_id	integer	所属卷 ID。
data.asset.asset_type	string	数据资产类型。
data.asset.asset_ref	string	数据资产引用标识。
data.asset.source	string	数据资产来源。
data.asset.meta	object	数据资产扩展元数据。
data.asset.created_at	integer	创建时间的 Unix 时间戳（秒）。
data.asset.updated_at	integer	更新时间的 Unix 时间戳（秒）。
data.derivations	array	资产派生关系。
data.manifest	object	原始文件与解析产物的映射元数据；没有时可能省略。
data.assets_by_id	object	按资产 ID 索引的相关资产。

错误响应

{
  "code": "ErrNotFound",
  "msg": "对象不存在",
  "data": null
}

常见 HTTP 错误

HTTP 状态码	错误代码	常见原因	建议操作
400	ErrParamInvalid	路径中的 file_id 缺失或无效。	传入有效的原始文件 ID。
403	ErrForbidden	当前身份没有所属根卷读取权限。	使用有读取权限的凭据，或联系管理员授权。
404	ErrNotFound	文件不存在，或文件尚未生成数据资产。	检查文件 ID；如需产物，请先完成相应处理流程。
500	ErrServer	服务无法解析数据资产。	记录请求时间和错误信息后重试；持续失败时联系支持人员。

后续操作

需要修改时更新数据库。返回列表时查询文件产物。

最后更新于 2026 年 8 月 22 日