接口功能介绍
此接口用于初始化分片上传。
接口约束
无
URI
POST /{bucket}/{objectName}?uploads
路径参数
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
| bucket |
是 |
String |
桶名称 |
testBucket |
| objectName |
是 |
String |
对象名称 |
test |
Query参数
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
| uploads |
是 |
String |
固定参数 |
uploads |
|
请求参数
请求头header参数
| 参数 |
参数类型 |
说明 |
示例 |
| x-amz-storage-class |
StorageClass |
对象存储类别 |
GLACIER(归档), STANDARD_IA(低频), STANDARD(标准，默认) |
| Authorization |
String |
是 |
用于验证请求合法性的认证信息 |
请求体body参数
无
响应参数
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
| InitiateMultipartUploadResult |
是 |
Array of Objects |
结果列表 |
|
InitiateMultipartUploadResult |
表 InitiateMultipartUploadResult
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
| Bucket |
是 |
String |
将会接收对象的存储桶 |
testlsskls2 |
|
| Key |
是 |
String |
对象的key |
test3.png |
|
| UploadId |
是 |
String |
UploadId用于标识分段上传 |
2~xV3umxNY7f********** |
|
请求示例
POST /testlsskls2/test3.png?uploads
请求头header
Authorization: authorization string
x-amz-storage-class: GLACIER
请求体body
无
响应示例
HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>testlsskls2</Bucket>
<Key>test3.png</Key>
<UploadId>2~xV3umxNY7f**********</UploadId>
</InitiateMultipartUploadResult>
状态码
| HTTP状态 |
错误码 |
描述 |
| 200 |
|
操作成功 |
| 400 |
InvalidObjectName |
对象的名字不合法 |
| 400 |
InvalidArgument |
存储类型设置不合法 |
| 403 |
AccessDenied |
用户没有权限执行操作 |
| 404 |
NoSuchBucket |
操作指定的桶不存在 |
错误码
请参考 请求错误码（原生接口）。
