批量查询数据资产

按原始文件 ID 批量查询已生成的数据资产。未处理的文件不会出现在结果中。

POST https://api.moi.matrixorigin.cn/v5/catalog/data-assets/batch-get

调用前准备

先查询文件列表取得文件 ID。准备可访问目标工作区的个人访问令牌、目标工作区 ID 和文件 ID 列表。请求中的空文件 ID 会被忽略，重复 ID 只按首次出现处理。

请求体

curl -X POST "https://api.moi.matrixorigin.cn/v5/catalog/data-assets/batch-get" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "raw_file_ids": ["'"$FILE_ID"'"]
  }'

字段

类型

是否必填

说明

raw_file_ids

string（字符串数组）

是

要查询的原始文件 ID 列表。

服务整理文件 ID 后，每次最多处理 100 个目标。超过时返回 HTTP 400。需要查询更多文件时，分批调用。

成功响应

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "items": [
      {
        "id": 1,
        "asset_id": "asset-01",
        "name": "orders.csv",
        "raw_file_id": "file-01",
        "volume_id": 10,
        "asset_type": "file"
      }
    ],
    "total": 1
  }
}

字段

类型

说明

code

string

成功时为 OK。

msg

string

成功时为 OK。

data.items

object（对象数组）

已解析到的数据资产列表。

data.total

integer

返回的数据资产数量。

data.items[].id

integer

数据资产记录 ID。

data.items[].asset_id

string

数据资产标识。

data.items[].name

string

数据资产名称。

data.items[].raw_file_id

string

对应的原始文件 ID。

data.items[].volume_id

integer

所属根卷 ID。

data.items[].source

string

数据资产来源。适用时返回。

data.items[].meta

object

扩展元数据。键由处理链路写入，服务端未定义固定键集。

data.items[].created_at

integer

创建时间的 Unix 时间戳（秒）。

data.items[].updated_at

integer

更新时间的 Unix 时间戳（秒）。

data.items[].asset_type

string

数据资产类型。

data.items[].asset_ref

string

数据资产引用标识。适用时返回。

错误响应

{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效"
}

字段

类型

说明

code

string

错误代码。

msg

string

错误信息。
最后更新于