查詢正在進行中的分段上傳
更新時間 2025-06-11 14:55:28
最近更新時間: 2025-06-11 14:55:28
分享文章
接口介紹
查詢正在進行中的分段上傳。
接口約束
支持的線上資源池 :上海7、南京3、南京5、杭州2、合肥2、九江、廣州6、武漢4、福州25、廈門3、郴州2、海口2、北京5、雄安2、石家莊20、內蒙6、晉中、遼陽1、西安5、烏魯木齊4、烏魯木齊27、中衛5、蘭州2、西寧2、拉薩3、昆明2、重慶2、成都4、貴州3、上海33、寧波邊緣云、華東1、上海36、南昌5、青島20、武漢41、長沙42、長沙37、南寧23、北京行業云20、華北2、西南1、上海32。
URI
GET /v4/oss/list-multipart-uploads
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| keyMarker | 否 | String | 只有Key大于KeyMarker的分段上傳數據才會返回 | nextkeyfrompreviousresponse |
| maxUploads | 否 | Integer | 單次最多返回的分段上傳數據,大小是1-1000,超過1000的數據會被視為1000 | 333 |
| prefix | 否 | String | Key的前綴,只有以Prefix為開頭的Key才會被返回 | hello_ |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| returnObj | Object | 響應對象 | 見下級對象 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| bucket | String | 啟動分段上傳的桶的名稱 | bk1 |
| keyMarker | String | 列表開始處或之后的 key | xciuvysaduhfgb |
| uploadIDMarker | String | 列出 uploadID 之后的分段 | sxcuyvibsdhyuifbe |
| nextKeyMarker | String | 當列表被截斷時,此元素指定應用于后續請求中的 key 標記請求參數的值 | xciuyvyasdbuhrgweuyuya |
| nextUploadIDMarker | String | 當列表被截斷時,此元素指定應用于后續請求中的 upload-id-marker 請求參數的值 | fcvobeiuowertdf |
| maxUploads | Integer | 可以包含在響應中的分段上傳的最大數量 | 22 |
| isTruncated | Boolean | 指示返回的分段列表是否被截斷。值為 true 表示列表已被截斷。如果分段上傳的數量超過最大上傳允許或指定的限制,則可以截斷該列表 | false |
| uploads | Array of Objects | 與特定分段上傳相關的元素的容器。響應可以包含零個或多個 Upload 元素 | 見下級對象 |
表 uploads
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| uploadID | String | uploadID | xcviuywsierbyhdfg |
| key | String | 對象名 | obj1 |
| initiated | String | 分段上傳初始化時間,ISO-8601 格式的日期字符串 | 2022-10-18T02:24:40Z |
| storageClass | String | 存儲類,可選的值由 STANDARD, STANDARD_IA, GLACIER | |
| owner | Object | 所有者 | 見下級對象 |
| initiator | Object | 初始化分段上傳事件的用戶 | 見下級對象 |
表 owner
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| displayName | String | 展示名稱 | dname1 |
| ID | String | 用戶ID | user1 |
表 initiator
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| displayName | String | 展示名稱 | dname2 |
| ID | String | 用戶ID | user2 |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/list-multipart-uploads?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0&keyMarker=nextkeyfrompreviousresponse&maxUploads=333&prefix=hello_
響應示例
{
"returnObj": {
"bucket": "bucket1",
"keyMarker": "nextkeyfrompreviousresponse",
"uploadIDMarker": "sxcuyvibsdhyuifbe",
"nextKeyMarker": "xciuyvyasdbuhrgweuyuya",
"nextUploadIDMarker": "fcvobeiuowertdf",
"maxUploads": 22,
"isTruncated": true,
"uploads": [
{
"uploadID": "xcviuywsierbyhdfg",
"key": "obj1",
"initiated": "2022-10-18T02:24:40Z",
"storageClass": "GLACIER_IR",
"owner": {
"displayName": "dname1",
"ID": "user1"
},
"initiator": {
"ID": "dname2",
"displayName": "user2"
}
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表