上传工作区文件记录¶
上传未关联到卷的工作区文件记录。
POST https://api.moi.matrixorigin.cn/v5/workspaces/{id}/files
调用前准备¶
BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。
准备目标工作区个人访问令牌;WORKSPACE_ID须与路径工作区一致,FILE_ID来自实际文件结果。BASE_URL包含同环境产品前缀,示例文件/ID仅为占位值。
请求参数¶
curl --fail-with-body -sS -X POST "$BASE_URL/workspaces/$WORKSPACE_ID/files" \
-H "X-API-Key: $MOI_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-F "file=@$UPLOAD_FILE;type=text/plain" \
-F "initial_ref_count=0"
字段 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
file |
是 |
multipart 文件。 |
|
integer |
否 |
初始引用计数,默认0,范围0至2147483647。 |
成功为HTTP201、数值code=0。上传本身不产生卷关联或智能体产物发布;正引用计数会影响删除。
成功响应¶
{
"code": 0,
"data": {
"file_id": "file-example",
"original_name": "sample.txt",
"size": 7,
"md5": "5177a58dc65c8a14dc90c69db3bf3dd2"
}
}
成功数值code=0;data含file_id、original_name、size、md5。没有msg字段。
错误响应¶
{
"code": 2,
"message": "示例错误信息"
}
请求字段无效为400/2;业务上传失败按数值code/message返回,内部写入失败可500/1。
最后更新于