本接口初始化一个分片上传（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
文件的存储类型，针对那些在成功完成分片上传后被创建的文件。
类型：字符串。
取值：
STANDARD：标准存储。
STANDARD_IA：低频访问存储。
默认值为STANDARD。
否
x-ctyun-data-location
设置Bucket的数据位置。
注意
香港节点不支持此参数。
类型：key-value形式。
取值：
格式为：type=Local,scheduleStrategy=scheduleStrategy或者type=Specified,location=location,scheduleStrategy=scheduleStrategy
type：指定数据存储位置的类型，取值为Local或者Specified。local表示就近写入，Specified表示指定位置。如果type取值为Specified，则需要指定具体的数据位置location，location可以填写多个，以逗号分隔，对于对象存储网络，可取值为：ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou；对于对象存储网络2，可取值为：NeiMeng1、HangZhou1。
scheduleStrategy：调度策略，取值为：
Allowed：允许OOS自动调度数据存储位置。
NotAllowed：不允许OOS自动调度数据存储位置。

响应结果

请求示例

初始化一个名为“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>