查询工作区文件元数据

按文件 ID 读取工作区文件元数据。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{id}/files/{file_id}

调用前准备

BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

准备目标工作区个人访问令牌;WORKSPACE_ID须与路径工作区一致,FILE_ID来自实际文件结果。BASE_URL包含同环境产品前缀,示例文件/ID仅为占位值。

请求参数

curl --fail-with-body -sS -X GET "$BASE_URL/workspaces/$WORKSPACE_ID/files/$FILE_ID" \
  -H "X-API-Key: $MOI_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

没有业务请求体。路径中的工作区和文件ID按实际目标填写。

成功数值code=0。来源会话/任务/调用/工具字段按可见性隐藏,不能从缺字段推断没有来源。

成功响应

{
  "code": 0,
  "data": {
    "file_id": "file-example",
    "original_name": "sample.txt",
    "size": 7,
    "md5": "5177a58dc65c8a14dc90c69db3bf3dd2",
    "ref_count": 1,
    "created_at": 1794390000,
    "created_by": "user-example",
    "updated_at": 1794390001,
    "source": "user_upload",
    "content_type": "text/plain",
    "storage_mode": "managed"
  }
}

成功数值code=0,data为17字段元数据,标量零值可省略。

错误响应

{
  "code": 2,
  "message": "示例错误信息"
}

业务读取不存在为404/3,权限拒绝为403/5,授权依赖不可用为503/15。数值code/message与列表的字符串包络分别处理。

最后更新于