查询工作区文件元数据¶
按文件 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与列表的字符串包络分别处理。
最后更新于