初始化分片上傳
更新時間 2024-01-02 11:21:24
最近更新時間: 2024-01-02 11:21:24
分享文章
接口介紹
此接口用于初始化分片上傳
接口約束
無
請求URI
POST /v1/uploads/{bucket}/{objectName}
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名稱 | testBucket |
| objectName | 是 | String | 對象名稱 | test |
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| uploads | 是 | String | 固定參數 |
注： 如果query中的參數為固定參數，可以傳參數名或傳空。
請求參數
請求頭header參數
無
請求體body參數
無
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| InitiateMultipartUploadResult | 是 | Array of Objects | 結果列表 | InitiateMultipartUploadResult |
表 InitiateMultipartUploadResult
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Bucket | 是 | String | 將會接收對象的存儲桶 | testlsskls2 | |
| Key | 是 | String | 對象的key | test3.png | |
| UploadId | 是 | String | UploadId用于標識分段上傳 | 2~xV3umxNY7f********** |
請求示例
POST /v1/uploads/testlsskls2/test3.png?uploads
請求頭header
無
請求體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 | 對象的名字不合法 |
| 403 | 用戶沒有權限執行操作 |
| 404 | 操作指定的桶不存在 |
