文件上传归一化
功能介绍
文件上传归一化
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/fileservice/file/upload
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 x-publisher-token和X-Auth-Token必传一个 |
x-publisher-token |
否 |
String |
发布商凭证,x-publisher-token和X-Auth-Token必传一个 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
file |
是 |
File |
文件 |
publisher_id |
否 |
String |
传用户token时，此字段为必传项 |
chunk_index |
是 |
Long |
分片索引，第几个分片 取值范围：1-100 |
merge |
是 |
Boolean |
是否合并已上传的分片（包含本次分片内容）,true |
total_chunk_num |
是 |
Long |
总分片数 0-100 |
parent_file_size |
是 |
Long |
父文件大小 |
parent_file_name |
是 |
String |
父文件名称 |
override |
是 |
Boolean |
是否覆盖原有文件 |
chunk_md5 |
是 |
String |
文件分片的md5,用于校验文件分片是否完整 |
parent_file_sha256 |
否 |
String |
父文件hash，用于校验合并后的文件 |
task_id |
否 |
String |
上传任务的唯一标识，第一次上传分片时可不传 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
result |
Object |
返回值 |
status |
String |
状态 |
状态码： 401
参数 |
参数类型 |
描述 |
|---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
状态码： 403
参数 |
参数类型 |
描述 |
|---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
状态码： 404
参数 |
参数类型 |
描述 |
|---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
请求示例
文件上传归一化
POST https://{endpoint}/v1/fileservice/file/upload
响应示例
状态码： 200
OK
{
"result" : {
"task_id" : "597a3fc9-a023-48fa-93bd-14386bf5936b"
},
"status" : "success"
}
状态码
状态码 |
描述 |
|---|---|
200 |
OK |
201 |
Created |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
错误码
请参见错误码。
