本接口初始化一个分片上传（Multipart Upload）操作，并返回一个上传ID。此ID用来将此次分片上传操作中上传的所有片段合并成一个文件。用户在执行每一次子上传请求（见Upload Part）时都必须指定该ID。用户也可以在表示整个分片上传完成的合并分片的请求中指定该ID。或者在用户放弃该分片上传操作时指定该ID。
请求语法
POST /ObjectName?uploads HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue请求头
| 名称 | 描述 | 是否必须 |
|---|---|---|
| Cache-Control | 可以用来指定请求或响应中的缓存操作。 类型：字符串。 | 否 |
| Content-Disposition | 指定文件的描述性信息。 类型：字符串。 | 否 |
| Content-Encoding | 指定文件的描述性信息采用何种编码方式以及在获取被Content-Type头字段引用的media-type时采用何种解码方式。 类型：字符串。 | 否 |
| Content-Type | 用来描述文件数据格式的标准MIME类型。 类型：字符串。 取值：MIME类型，默认值为application/octet-stream。 | 否 |
| Expires | 文件不再被缓存的时间。GMT时间格式。 类型：字符串。 | 否 |
| x-amz-meta- | 任何以x-amz-meta-为前缀的头都被当作用户元数据，它和文件一起存储，当用户获取该文件的时候作为响应的一部分被返回。 类型：字符串。 | 否 |
| x-amz-storage-class | 文件的存储类型，针对那些在成功完成分片上传后被创建的文件。 类型：字符串。 取值：
| 否 |
| x-ctyun-data-location | 设置Bucket的数据位置。 注意 香港节点不支持此参数。 类型：key-value形式 取值： 格式为：type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy
|
响应结果
| 名称 | 描述 |
|---|---|
| InitiateMultipartUploadResult | 包含所有返回元素的容器。 类型：容器。 子节点：Bucket，Key，UploadId。 |
| Bucket | 分片上传对应的Bucket的名称。 类型：字符串。 父节点：InitiateMultipartUploadResult。 |
| Key | 分片上传对应的文件名称。 类型：字符串。 父节点：InitiateMultipartUploadResult。 |
| UploadId | 分片上传ID。 类型：字符串。 父节点：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: SignatureValue响应示例
HTTP/1.1 200 OK
x-amz-request-id: 656c76696e672773207265717565737415ecaced5ddd5d7dda
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 197
Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Bucket>example-bucket</Bucket>
<Key>example-object</Key>
<UploadId>1638428231343309398</UploadId>
</InitiateMultipartUploadResult>
