獲取分片上傳任務列表
更新時間 2024-08-20 11:16:35
最近更新時間: 2024-08-20 11:16:35
分享文章
此接口可以列出存儲桶中已經初始化，但是還沒complete或者abort的分片上傳任務。
接口功能介紹
此接口可以列出存儲桶中已經初始化，但是還沒complete或者abort的分片上傳任務。
接口約束
無
URI
GET /{bucket}?uploads
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名稱 | testBucket |
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| uploads | 是 | String | 固定參數 | uploads |
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| Authorization | 是 | String | 用于驗證請求合法性的認證信息 |
請求體body參數
無
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ListMultipartUploadsResult | 是 | Array of Objects | 保存ListMultipartUpload請求結果的容器 | ListMultipartUploadsResult |
表 ListMultipartUploadsResult
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Bucket | 是 | String | 本次請求的存儲桶名稱 | example-bucket | |
| IsTruncated | 是 | Boolean | 指明是否已返回所有結果。true：表示本次沒有返回全部結果。 false：表示本次已返回全部結果 | true | |
| MaxUploads | 是 | Integer | 返回的最大分片上傳事件個數 | 10 | |
| NextKeyMarker | 是 | String | 如果本次沒有返回全部結果，響應請求中將包含NextKeyMarker元素，用于表示接下來請求的KeyMarker值 | test | |
| NextUploadIdMarker | 是 | String | 如果本次沒有返回全部結果，響應請求中將包含NextUploadMarker元素，用于表示接下來請求的UploadMarker值 | YW55IGlkZWEgd2************** | |
| Upload | 是 | Array of Objects | 保存Multipart Upload事件信息的容器 | -- | Key,UploadId,Initiator,Owner,StorageClass,Initiated |
表 Upload
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Key | 是 | String | 對象的Key | my-divisor | |
| UploadId | 是 | String | 分片上傳事件的id | XMgbGlrZSB****************2ggbHVjaw | |
| Initiated | 是 | String | 分片上傳事件的初始化時間 | 2010-11-10T20:48:33.000Z | |
| Initiator | 是 | Array of Objects | 初始化上傳用戶的ID和顯示名 | Initiator | |
| Owner | 是 | Array of Objects | 上傳對象擁有的ID和顯示名 | Owner | |
| StorageClass | 是 | String | 對象的存儲類型 | STANDARD |
表 Initiator
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ID | 是 | String | Initiator的ID | arn:aws:iam::111122223333:user | |
| DisplayName | 是 | String | Initiator的顯示名 | user1 |
表 Owner
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ID | 是 | String | Owner的ID | ***3795438795279 | |
| DisplayName | 是 | String | Owner的顯示名 | test |
請求示例
GET /testbucket?uploads
請求頭header
Authorization: authorization string
請求體body
無
響應示例
HTTP/1.1 200 OK
x-amz-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="//s3.amazonaws.com/doc/2006-03-01/">
<Bucket>example-bucket</Bucket>
<NextKeyMarker>test</NextKeyMarker>
<NextUploadIdMarker>YW55IGlkZWEgd2**************</NextUploadIdMarker>
<MaxUploads>3</MaxUploads>
<IsTruncated>true</IsTruncated>
<Upload>
<Key>my-divisor</Key>
<UploadId>XMgbGlrZSB****************2ggbHVjaw</UploadId>
<Initiator>
<ID>arn:aws:iam::111122223333:user/user1</ID>
<DisplayName>user1</DisplayName>
</Initiator>
<Owner>
<ID>***3795438795279 </ID>
<DisplayName>test</DisplayName>
</Owner>
<StorageClass>STANDARD</StorageClass>
<Initiated>2010-11-10T20:48:33.000Z</Initiated>
</Upload>
</ListMultipartUploadsResult>
狀態碼
| HTTP狀態 | 錯誤碼 | 描述 |
|---|---|---|
| 200 | 操作成功 | |
| 403 | AccessDenied | 用戶沒有權限執行操作 |
錯誤碼
請參考 請求錯誤碼（原生接口）。
