本接口初始化一個分片上傳（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="//s3.amazonaws.com/doc/2006-03-01/">
<Bucket>example-bucket</Bucket>
<Key>example-object</Key>
<UploadId>1638428231343309398</UploadId>
</InitiateMultipartUploadResult>
