查詢對象版本信息
更新時間 2025-06-11 14:55:26
最近更新時間: 2025-06-11 14:55:26
分享文章
接口介紹
查詢對象的版本信息
接口約束
支持的線上資源池 :上海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-object-versions
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| keyMarker | 否 | String | 指示從哪里開始列出。ZOS 會在這個指定的鍵之后開始列出。標記可以是桶中的任何鍵。默認值為空字符串 ""。 | test1.txt |
| prefix | 否 | String | 返回的key的前綴,注意 key 與 prefix 完全相同的對象不會返回。默認值為空字符串 ""。 | test |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| returnObj | Object | 響應對象 | 見下級對象 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| keys | Array of Objects | 具有 prefix 前綴的對象列表。 | 見下級對象 |
| nextKeyMarker | String | 下一個 keyMarker。若沒有則為 null。 | test2.txt |
| keyMarker | String | 標記截斷響應中返回的最后一個 key。 | test1.txt |
| deleteMarkers | Array of Objects | 作為刪除標記的對象的容器。 | 見下級對象 |
表 keys
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| key | String | 對象名 | test0.txt |
| versions | String | 版本信息 | 見下級對象 |
表 versions
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| lastModified | String | 最后修改時間,為 ISO 8601 格式 | 2022-10-18T02:24:40Z |
| versionID | String | 版本ID,在開啟多版本時可使用 | PHtexPGjH2y.zBgT8LmB7wwLI2mpbz.k |
| ETag | String | ETag | "93837f55f5f0cf47b7411c522be99684-1" |
| storageClass | String | 存儲類型 | STANDARD |
| key | String | 對象名 | test0.txt |
| owner | Object | 所有者 | 見下級對象 |
| isLatest | Boolean | 是否為最新版本 | true |
| size | Integer | 對象的大小,單位為字節 | 10 |
表 deleteMarkers
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| lastModified | String | 最后修改時間,為 ISO 8601 格式 | 2022-10-18T02:24:40Z |
| versionID | String | 版本ID,在開啟多版本時可使用 | PHtexPGjH2y.zBgT8LmB7wwLI2mpbs.k |
| key | String | 對象名 | test01.txt |
| owner | Object | 創建刪除標記的賬戶 | 見下級對象 |
| isLatest | Boolean | 是否為最新版本 | true |
表 owner
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| displayName | String | 展示名 | user1 |
| ID | String | 用戶 ID | 12345example25102679df27bb0ae12b3f85be6f290b |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/list-object-versions?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0&prefix=test
響應示例
{
"returnObj": {
"keys": [
{
"key": "test0.txt",
"versions": [
{
"lastModified": "2022-10-18T02:24:40Z",
"versionID": "PHtexPGjH2y.zBgT8LmB7wwLI2mpbz.k",
"ETag": "\"93837f55f5f0cf47b7411c522be99684-1\"",
"storageClass": "STANDARD",
"key": "test0.txt",
"owner": {
"displayName": "user1",
"ID": "12345example25102679df27bb0ae12b3f85be6f290b"
},
"isLatest": true,
"size": 10
},
{
"lastModified": "2022-10-18T02:24:40Z",
"versionID": "MHtexPGjH2y.zBgT8LmB7wwLI2mpbz.W",
"ETag": "\"93837f55f5f0cf47b7411c522be99633-2\"",
"storageClass": "STANDARD",
"key": "test0.txt",
"owner": {
"displayName": "user1",
"ID": "12345example25102679df27bb0ae12b3f85be6f290b"
},
"isLatest": false,
"size": 12
}
]
},
{
"key": "test0.txt2",
"versions": [
{
"lastModified": "2022-10-18T02:24:40Z",
"versionID": "sHtexPGjH2y.zBgT8LmB7wwLI2mpbz.f",
"ETag": "\"77837f55f5f0cf47b7411c522be99688-6\"",
"storageClass": "STANDARD",
"key": "test0.txt2",
"owner": {
"displayName": "user1",
"ID": "12345example25102679df27bb0ae12b3f85be6f290b"
},
"isLatest": true,
"size": 10
}
]
}
],
"nextKeyMarker": null,
"keyMarker": "",
"deleteMarkers": [
{
"lastModified": "2022-10-18T02:24:40Z",
"versionID": "GGGxPGjH2y.zBgT8LmB7wwLI2mpTT.u",
"key": "test0.txt3",
"owner": {
"displayName": "user2",
"ID": "7890example25102679df27bb0ae12b3f85be6f786d"
},
"isLatest": false
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表