初始化分片上傳
更新時間 2024-08-20 11:16:34
最近更新時間: 2024-08-20 11:16:34
分享文章
此接口用于初始化分片上傳。
接口功能介紹
此接口用于初始化分片上傳。
接口約束
無
URI
POST /{bucket}/{objectName}?uploads
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名稱 | testBucket |
| objectName | 是 | String | 對象名稱 | test |
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| uploads | 是 | String | 固定參數 | uploads |
請求參數
請求頭header參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| x-amz-storage-class | StorageClass | 對象存儲類別 | GLACIER(歸檔), STANDARD_IA(低頻), STANDARD(標準，默認) |
| Authorization | String | 是 | 用于驗證請求合法性的認證信息 |
請求體body參數
無
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| InitiateMultipartUploadResult | 是 | Array of Objects | 結果列表 | InitiateMultipartUploadResult |
表 InitiateMultipartUploadResult
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Bucket | 是 | String | 將會接收對象的存儲桶 | testlsskls2 | |
| Key | 是 | String | 對象的key | test3.png | |
| UploadId | 是 | String | UploadId用于標識分段上傳 | 2~xV3umxNY7f********** |
請求示例
POST /testlsskls2/test3.png?uploads
請求頭header
Authorization: authorization string
x-amz-storage-class: GLACIER
請求體body
無
響應示例
HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult xmlns="//s3.amazonaws.com/doc/2006-03-01/">
<Bucket>testlsskls2</Bucket>
<Key>test3.png</Key>
<UploadId>2~xV3umxNY7f**********</UploadId>
</InitiateMultipartUploadResult>
狀態碼
| HTTP狀態 | 錯誤碼 | 描述 |
|---|---|---|
| 200 | 操作成功 | |
| 400 | InvalidObjectName | 對象的名字不合法 |
| 400 | InvalidArgument | 存儲類型設置不合法 |
| 403 | AccessDenied | 用戶沒有權限執行操作 |
| 404 | NoSuchBucket | 操作指定的桶不存在 |
錯誤碼
請參考 請求錯誤碼（原生接口）。
