Appearance
InitiateMultipartUpload
接口描述
InitiateMultipartUpload是MultipartUpload的第一步，此命令向FOS请求一个全局唯一的UploadId，用于表示此次MultipartUpload，在MultipartUpload后续两个步骤都需要此UploadId，请求者也可以通过UploadId来查询上传的进度或者中断这次上传操作。
请求（Request）
请求语法
POST /<BucketName>/<ObjectName>?uploads HTTP/1.1
Host: fos.flymeyun.com
Date: <Date>
Content-Type: text/plain
Content-Length: <ContentLength>请求头域
| 名称 | 类型 | 描述 | 是否必需 |
|---|---|---|---|
| Cache-Control | String | 下载Object的Cache设置，常见的可取值为private、no-cache、max-age、must-revalidate | 否 |
| Expires | String | 设置下载Object时的缓存失效时间 | 否 |
请求参数
| 名称 | 类型 | 参数位置 | 描述 | 是否必需 |
|---|---|---|---|---|
| uploads | String | Query参数 | 分块上传的请求 | 是 |
响应（Response）
响应头域
无
响应元素
| 名称 | 类型 | 描述 |
|---|---|---|
| bucket | String | Bucket名称 |
| key | String | Object名称 |
| uploadId | String | 全局唯一ID，用于标识此次MultiUpload操作 |
注意事项
- 使用MultipartUpload上传的Object，如不指定Content-Type，FOS会自动识别设置合适的Content-Type，若无法识别则默认为application/octet-stream。
- InitiateMultipartUpload获取的UploadId将用于MultiUpload的后续2步操作，也可以用此UploadId来查询整个MultiUpload的进度和中断此次MultiUpload操作。
示例
请求示例
POST /BucketName/ObjectName?uploads
Host: fos.flymeyun.com
Date: Wed, 06 Apr 2016 06:34:40 GMT
Content-Length: 0响应示例
HTTP/1.1 200 OK
x-fos-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
Date: Wed, 06 Apr 2016 06:34:40 GMT
Content-Length: 197
Connection: keep-alive
{
"bucket": "BucketName",
"key":"ObjectName",
"uploadId": "a44cc9bab11cbd156984767aad637851"
}