完成分片上傳
更新時間 2024-08-20 11:16:34
最近更新時間: 2024-08-20 11:16:34
分享文章
此接口用于完成分片上傳。
接口功能介紹
此接口用于完成分片上傳。
接口約束
無
URI
POST /{bucket}/{objectName}?uploadId={uploadId}
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名稱 | testBucket |
| objectName | 是 | String | 對象名稱 | test |
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| uploadId | 是 | String | 上傳任務ID | 2~xV3umxNY7f********** |
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | 消息體格式 | application/xml | |
| Authorization | 是 | String | 用于驗證請求合法性的認證信息 |
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| CompleteMultipartUpload | 是 | Array of Objects | 保存合并分片請求內容 | CompleteMultipartUpload |
表 CompleteMultipartUpload
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Part | 是 | Array of Objects | 保存已上傳分片 | Part |
表 Part
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| PartNumber | 是 | String | 標識分片的維一編碼 | 1 | |
| ETag | 是 | String | 分片上傳成功后，服務返回的ETAG值 | c4468aa79a******************6ced |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| CompleteMultipartUploadResult | 是 | Array of Objects | 包含響應的容器 | CompleteMultipartUploadResult |
表 CompleteMultipartUploadResult
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Bucket | 是 | String | 對象所在的存儲桶名稱 | testBucket | |
| Key | 是 | String | 對象的key | test | |
| Etag | 是 | String | 對象的Etag值 | 3858f6**********12c11f-9 | |
| Location | 是 | String | 新對象的位置 | xzoss.xstore.daliqc.cn/testBucket/test |
請求示例
POST /testbucket/test?uploadId=2~xV3umxNY7f**********
請求頭header
Authorization: authorization string
Content-Type: application/xml
請求體body
<CompleteMultipartUpload>
<Part>
<PartNumber>1</PartNumber>
<ETag>"a54357aff0632cce46d942af68356b38"</ETag>
</Part>
<Part>
<PartNumber>2</PartNumber>
<ETag>"0c78aef83f66abc1fa1e8477f296d394"</ETag>
</Part>
<Part>
<PartNumber>3</PartNumber>
<ETag>"acbd18db4cc2f85cedef654fccc4a4d8"</ETag>
</Part>
</CompleteMultipartUpload>
響應示例
HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult
xmlns="//s3.amazonaws.com/doc/2006-03-01/">
<Location>xzoss.xstore.daliqc.cn/testBucket/test</Location>
<Bucket>testBucket</Bucket>
<Key>test</Key>
<ETag>2ea248f54bd2c366a5f6daf5a66d6cf8-1</ETag>
</CompleteMultipartUploadResult>
狀態碼
| HTTP狀態 | 錯誤碼 | 描述 |
|---|---|---|
| 200 | 操作成功 | |
| 400 | InvalidObjectName | 對象的名字不合法 |
| 400 | InvalidPart | 合并分片的數量有問題，一個或者多個指定的分片未找到 |
| 403 | AccessDenied | 用戶沒有權限執行操作 |
| 404 | NoSuchBucket | 操作指定的桶不存在 |
| 404 | NoSuchUpload | UploadId不存在或者UploadId正在合并中 |
錯誤碼
請參考 請求錯誤碼（原生接口）。
