获取分片上传限制

1. 接口定位

• 接口名称: 获取分片上传限制
• 所属域: object
• 业务目标: 返回对象存储分片上传的大小与分片数量限制，供客户端计算分片策略

2. 请求定义

• Method: POST
• Path: /object/part_limit
• Content-Type: 推荐 application/json
• operationID: 必填，请通过 Header operationID 传入
• 鉴权: 必填，需要通过 Header token 传入有效令牌
• 幂等性: 幂等（只读操作）

3. 请求参数

Header 参数

字段	必填	类型	说明
operationID	是	string	链路追踪 ID
token	是	string	登录令牌

Body 参数

该接口无业务参数，请传空对象 {}。

4. 响应结构

通用响应包裹

字段	类型	说明
errCode	int	错误码，0 表示成功
errMsg	string	错误简述
errDlt	string	错误详情
data	any	业务数据

data 字段结构

字段	类型	说明
minPartSize	int64	单个分片最小大小（字节）
maxPartSize	int64	单个分片最大大小（字节）
maxNumSize	int32	允许的最大分片数

5. 业务规则

• 调用方持有合法 token 即可调用，无角色限制。
• 建议在上传前先调用本接口，确保客户端分片策略符合后端限制。

6. 错误码与失败场景

错误码	场景	典型报错
500	服务内部错误（对象存储配置读取失败等）	ServerInternalError

7. 示例

fetch 请求示例

fetch("http://localhost:10002/object/part_limit", {
  method: "POST",
  headers: {
    operationID: "36fd0ed0-5779-44d4-a2e7-c5df1f9e6c3e",
    token: "<your-token>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
})
  .then((res) => res.json())
  .then((data) => console.log(data));

请求示例（JSON）

{}

成功响应示例

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "minPartSize": 5242880,
    "maxPartSize": 5368709120,
    "maxNumSize": 10000
  }
}

8. 时序流程

1. 客户端调用 part_limit 获取后端上传限制。
2. 按限制计算分片大小和分片数量。
3. 再调用 initiate_multipart_upload 发起上传。

9. 变更记录

• 2026-06-20: 首版补充文档发布。