文档简介：
Initial Multipart Upload
本接口初始化一个分片上传（Multipart Upload）操作，并返回一个上传ID，此ID用来将此次分片上传操作中上传的所有片段合并成一个对象。用户在执行每一次子上传请求（见Upload Part）时都必须指定该ID。用户也可以在表示整个分片上传完成的合并分片的请求中指定该ID。或者在用户放弃该分片上传操作时指定该ID。
请求语法
|
POST /ObjectName?uploadsHTTP/1.1 Host: bucketName.oos-cn.ctyunapi.cn Date: date Authorization: signatureValue |
请求头格式
|
描述 |
是否必需 |
|
|
Cache-Control |
可以用来指定请求或响应中的缓存操作。 类型：String 默认值：None |
否 |
|
Content- Disposition |
指定对象的描述性信息。 类型：String 默认值：None |
否 |
|
Content-Encoding |
指定对象的描述性信息采用何种编码方式以及在获取被Content-Type头字段引用的media-type时采用何种解码方式。 类型：String 默认值：None |
否 |
|
Content-Type |
用来描述对象数据格式的标准MIME类型。 类型：String 默认值：application/octet-stream 限制：仅MIME类型 |
否 |
|
Expires |
对象不再被缓存的时间。 类型：String |
否 |
|
x-amz-meta- |
任何以x-amz-meta-为前缀的头都被当作用户元数据，它和对象一起存储，当用户获取该对象的时候作为响应的一部分被返回。 |
否 |
|
x-amz-storage-class |
对象的存储类型，针对那些在成功完成分片上传后被创建的对象。 类型：String 取值： l STANDARD：标准存储 l REDUCED_REDUNDANCY：低冗余存储 l STANDARD_IA：低频访问存储 默认值为STANDARD |
否 |
|
x-ctyun-data-location |
设置Bucket的数据位置。 类型：key-value形式。 有效值： 格式为：type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy l type：指定数据存储位置的类型，取值为Local或者Specified。local表示就近写入，Specified表示指定位置。如果type取值为Specified，则需要指定具体的数据位置location，location可以填写多个，以逗号分隔，可取值为ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 l scheduleStrategy：调度策略，取值为： Ø Allowed：允许OOS自动调度数据存储位置 Ø NotAllowed：不允许OOS自动调度数据存储位置。
|
否 |
返回元素
|
名称 |
描述 |
|
包含所有返回元素的容器。 类型：容器 子节点：Bucket，Key，UploadId 父节点：无 |
|
|
Bucket |
分片上传对应的Bucket的名称。 类型：Sring 父节点：InitiateMultipartUploadResult |
|
Key |
分片上传对应的对象名称。 类型：String 父节点：InitiateMultipartUploadResult |
|
UploadId |
分片上传ID。 类型：String 父节点：InitiateMultipartUploadResult |
请求示例
示例中执行的操作是初始化一个名为“example-object”对象的分片上传操作。
|
POST /example-object?uploads HTTP/1.1 Host: example-bucket.oos-cn.ctyunapi.cn Date: Mon, 1 Nov 2010 20:34:56 GMT Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE= |
返回示例
|
HTTP/1.1 200 OK x-amz-request-id: 656c76696e6727732072657175657374 Date: Mon, 1 Nov 2010 20:34:56 GMT Content-Length: 197 Connection: close Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?> <InitiateMultipartUploadResult xmlns="/doc/2006-03-01/"> <Bucket>example-bucket</Bucket> <Key>example-object</Key> <UploadId>VXBsb2FkIElEIGZvciA2aWWpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId> </InitiateMultipartUploadResult> |
