接口介绍
列出存储桶下全部或者指定对象的版本。
接口约束
无
请求URI
GET /v1/versions/{bucket}
路径参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
bucket | 是 | String | 桶名称 | testBucket |
Query 参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
versions | 是 | String | 固定参数 | versions |
注: 如果query中的参数为固定参数,可以传参数名或传空
请求参数
请求头header参数
无
请求体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 | |
ActualSize | 是 | Integer | 对象大小 | 852 | |
StorageClass | 是 | String | 对象存储类型 | STANDARD | |
Owner | 是 | Array of Objects | 所属用户 | Owner | |
Type | 是 | String | 对象类型 | Normal |
表 Owner
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
ID | 是 | String | 用户id | test01 | |
DisplayName | 是 | String | 用户昵称 | test01 |
请求示例
GET /v1/versions/testBucket?versions HTTP/1.1
请求头header
无
请求体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="http://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>
<ActualSize>852</ActualSize>
<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>
<ActualSize>852</ActualSize>
<StorageClass>STANDARD</StorageClass>
<Owner>
<ID>test01</ID>
<DisplayName>test01</DisplayName>
</Owner>
<Type>Normal</Type>
</Version>
</ListVersionsResult>
状态码
状态码 | 描述 |
---|---|
200 | 操作成功。 |
400 | 桶的名字不合法 |
403 | 用户没有权限执行操作。 |
404 | 操作指定的桶不存在。 |