列出上傳對象的全部分段
更新時間 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-parts
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| bucket | 是 | String | 桶名 | bucket1 |
| key | 是 | String | 對象名 | obj1 |
| maxParts | 否 | Integer | 返回的最大分塊數 | 123 |
| partNumberMarker | 否 | Integer | 指定列表應該開始的位置。只會列出比這個編號更高的分塊。 | 103 |
| uploadID | 是 | String | uploadID | xxxxxxxx |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| returnObj | Object | 響應對象 | 見下級對象 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| bucket | String | 文件上傳的Bcuket名稱 | bk1 |
| nextPartNumberMarker | Integer | 下一次list的時候的分段起始編號,主要用于截斷返回時(也就是已上傳的分段數目大于當前返回的分段數目),作為下一次list的分段起始編號 | 5 |
| parts | Array of Objects | 已經上傳的分段信息 | 見下級對象 |
| uploadID | String | 分段上傳的ID | cxvibasidubeuwdfg |
| storageClass | String | 分段上傳的文件對應的存儲級別 | STANDARD |
| key | String | 分段上傳的文件在集群中保存的名字 | obj1 |
| owner | Object | 分段上傳的文件所屬用戶 | 見下級對象 |
| maxParts | Integer | 當前list最多返回的分段數目 | 30 |
| isTruncated | Boolean | 指示返回的分段列表是否被截斷。值為 true 表示列表已被截斷。 | true |
| partNumberMarker | Integer | 當前list的分段起始編號 | 3 |
表 owner
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| displayName | String | 展示名稱 | dname1 |
| ID | String | 用戶名 | user1 |
表 parts
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| partNumber | Integer | 分段編號 | 3 |
| size | Integer | 分段大小(單位 Bytes) | 43 |
| Etag | String | 該分段數據對應Etag | cvbuiysdfbntertcvius |
| lastModified | String | 該分段上次被修改的時間,ISO-8601 格式的日期字符串 | 2022-10-18T02:24:40Z |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/list-parts?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0&key=obj1&maxParts=123&partNumberMarker=103&uploadID=xxxxxxxx
響應示例
{
"returnObj": {
"bucket": "bk1",
"key": "obj1",
"uploadID": "cxvibasidubeuwdfg",
"partNumberMarker": 3,
"nextPartNumberMarker": 5,
"maxParts": 30,
"isTruncated": true,
"parts": [
{
"partNumber": 3,
"lastModified": "2022-10-18T02:24:40Z",
"ETag": "cvbuiysdfbntertcvius",
"size": 43
}
],
"owner": {
"displayName": "dname1",
"ID": "user1"
},
"storageClass": "STANDARD"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表