查詢桶內碎片列表
更新時間 2025-06-11 14:55:25
最近更新時間: 2025-06-11 14:55:25
分享文章
接口介紹
列出桶內所有分段上傳的碎片。
接口約束
支持的線上資源池 :上海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-all-parts
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| page | 否 | Integer | 頁碼。默認1 | 1 |
| pageSize | 否 | Integer | 每頁展示的最大分段數量。取值范圍 1~50,默認值為 10 | 10 |
| pageNo | 否 | Integer | 頁碼,若與參數 page 同時存在,以 pageNo 為準。默認值 1 | 1 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| returnObj | Object | 響應對象 | 見下級對象 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| result | Array of Objects | 規則詳情的數組 | 見下級對象 |
| totalCount | Integer | 總數 | 1 |
| currentCount | Integer | 當前頁記錄數 | 20 |
表 result
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| bucket | String | 桶名 | 5c9744ca-f3b6-11ec-ad4e-00505689ac50 |
| uploadID | String | 分段上傳ID | 2-Hjqr_4lnvKBrEuPPuL0aKk6oZV3I |
| key | String | 對象名 | 2-Hjqr_4lnvKBrEuPPuL0aKk6oZV3I |
| fragmentSize | Integer | 當前段上傳內碎片大小 | 1024 |
| partInfo | Array | 當前分段上傳內的碎片列表 | 見下級對象 |
表 partInfo
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| lastModified | String | 最后修改時間,為 ISO 8601 格式 | 2022-10-18T02:24:40Z |
| partNumber | Integer | 分段編號 | 2 |
| ETag | String | ETag | 4lnvKBrEuPPuL0aKk6oZV3I |
| size | Integer | 分段大小(單位 Bytes) | 1024 |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/list-all-parts?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0&page=1&pageSize=10
響應示例
{
"returnObj": {
"totalCount": 2,
"currentCount": 20,
"result": [
{
"bucket": "bucket1",
"key": "pload2",
"uploadID": "2~6L-Hjqr_4lnvKBrEuPPuL0aKk6oZV3I",
"fragmentSize": 35,
"partInfo": [
{
"lastModified": "2023-02-28T12:28:29Z",
"partNumber": 1,
"ETag": "\"fa3fb6e0dccc657b57251c97db271b05\"",
"size": 4
},
{
"lastModified": "2023-03-01T01:43:39Z",
"partNumber": 2,
"ETag": "\"ae0157be88d66ee2090d572bcbf4ad8d\"",
"size": 31
}
]
},
{
"bucket": "bucket-zs1",
"key": "test2/p1",
"uploadID": "2~_erk6-OzeIvoIBTYkPPfKOtEZsVpPEy",
"fragmentSize": 36,
"partInfo": [
{
"lastModified": "2023-03-01T07:16:39Z",
"partNumber": 1,
"ETag": "\"7ec45540ccb0db9b0e15cac65fb0d4ad\"",
"size": 36
}
]
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表