列出對象版本信息
更新時間 2024-08-20 11:16:30
最近更新時間: 2024-08-20 11:16:30
分享文章
列出存儲桶下全部或者指定對象的版本。
接口功能介紹
列出存儲桶下全部或者指定對象的版本。
接口約束
無
URI
GET /{bucket}?versions
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名稱 | testBucket |
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| versions | 是 | String | 固定參數 | versions |
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Authorization | 是 | String | 用于驗證請求合法性的認證信息 |
請求體body參數
無
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ListVersionsResult | 是 | Array of Objects | 對象版本列表 | ListVersionsResult |
表 ListVersionsResult
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Name | 是 | String | 本次請求的存儲桶名稱 | test-bucket-1 | |
| Prefix | 是 | String | 本次請求中指定的prefix | ||
| MaxKeys | 是 | Integer | 響應請求內返回結果的最大數目 | 10 | |
| IsTruncated | 是 | Boolean | 指明是否已返回所有結果 true：表示本次沒有返回全部結果 false：表示本次已返回全部結果 |
||
| KeyMarker | 是 | String | 標識本次請求開始的對象名稱 | ||
| VersionIdMarker | 是 | String | 與KeyMarker參數一同使用，以指定GetBucketVersions的起點 | ||
| Version | 是 | Array of Objects | 保存除刪除標記以外的對象版本的容器 | Version |
表 Version
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Key | 是 | String | 對象key | key1 | |
| VersionId | 是 | String | 對象版本號 | qCFhX426uSDK-KN5dG0DtnkqIIFZBao | |
| IsLatest | 是 | Boolean | 是否最新版本 | false | |
| LastModified | 是 | String | 最近修改時間 | 2022-09-15T07:17:49.763Z | |
| ETag | 是 | String | 對象唯一標識 | fc63ad72b40bfef53 | |
| Size | 是 | Integer | 對象大小 | 852 | |
| StorageClass | 是 | String | 對象存儲類型 | STANDARD | |
| Owner | 是 | Array of Objects | 所屬用戶 | Owner | |
| Type | 是 | String | 對象類型 | Normal |
表 Owner
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ID | 是 | String | 用戶id | test01 | |
| DisplayName | 是 | String | 用戶昵稱 | test01 |
請求示例
GET /testBucket?versions HTTP/1.1
請求頭header
Authorization: authorization string
請求體body
無
響應示例
HTTP/1.1 200 OK
x-amz-request-id: tx000000000000000000274-00632298b2-3b9ae-default
Date: Wed, 06 Sep 2017 12:00:00 GMT
<?xml version="1.0" encoding="UTF-8"?>
<ListVersionsResult xmlns="//s3.amazonaws.com/doc/2006-03-01/">
<Name>test-bucket-1</Name>
<Prefix></Prefix>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<KeyMarker></KeyMarker>
<VersionIdMarker></VersionIdMarker>
<Version>
<Key>key1</Key>
<VersionId>qCFhX426uSDK-KN5dG0DtnkqIIFZBao</VersionId>
<IsLatest>true</IsLatest>
<LastModified>2022-09-15T07:17:49.763Z</LastModified>
<ETag>"fc63ad72b40bfebf15d4b376566a5f53"</ETag>
<Size>852</Size>
<StorageClass>STANDARD</StorageClass>
<Owner>
<ID>test01</ID>
<DisplayName>test01</DisplayName>
</Owner>
<Type>Normal</Type>
</Version>
<Version>
<Key>key1</Key>
<VersionId>siwkNfUqBCaWvLeH3cW9.E1lfKQHniU</VersionId>
<IsLatest>false</IsLatest>
<LastModified>2022-09-15T07:17:41.614Z</LastModified>
<ETag>"fc63ad72b40bfebf15d4b376566a5f53"</ETag>
<Size>852</Size>
<StorageClass>STANDARD</StorageClass>
<Owner>
<ID>test01</ID>
<DisplayName>test01</DisplayName>
</Owner>
<Type>Normal</Type>
</Version>
</ListVersionsResult>
狀態碼
| 狀態碼 | 錯誤碼 | 描述 |
|---|---|---|
| 200 | 操作成功 | |
| 400 | InvalidBucketName | 桶的名字不合法 |
| 403 | AccessDenied | 用戶沒有權限執行操作 |
| 404 | NoSuchBucket | 操作指定的桶不存在 |
錯誤碼
請參考 請求錯誤碼（原生接口）。
