ListObjectVersions
更新时间 2026-04-10 20:09:10
最近更新时间: 2026-04-10 20:09:10
功能说明
ListObjectVersions请求列出Bucket中的对象版本。
请求消息样式
GET /{Bucket}/?versions&delimiter=Delimiter&key-marker=KeyMarker&version-id-marker=VersionIdMarker&max-keys=MaxKeys&prefix=Prefix HTTP/1.1
Host: xxx.zos.ctyun.cn
X-Amz-Content-Sha256: Content-SHA256
X-Amz-Date: Date
Authorization: Auth String
Accept-Encoding: Identity请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释: 桶的名称。 | String | 是 |
| key-marker | 参数解释: 列举多版本key的起始位置, 返回的列表将是以key名按照字典序排在该参数后的对象。 | String | 否 |
| version-id-marker | 参数解释: 列举多版本key的版本号的起始位置, 返回的列表将是以版本号按照字典序排在该参数后的对象。 | String | 否 |
| delimiter | 参数解释: 对对象名称进行分组的字符。 | String | 否 |
| max-keys | 参数解释: 0-1000 1000 | Long | 否 |
| prefix | 参数解释: 返回的多版本key的前缀。 | String | 否 |
请求消息头
该请求使用公共的请求消息头,请参见如何调用API-构造请求-请求消息头。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: Request Id
Date: Date
Content-Type: application/xml
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<ListVersionsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Name>bucket</Name>
<Prefix>prefix</Prefix>
<MaxKeys>maxKeys</MaxKeys>
<IsTruncated>false</IsTruncated>
<KeyMarker>keyMarker</KeyMarker>
<NextKeyMarker>nextKeyMarker</NextKeyMarker>
<VersionIdMarker>versionIdMarker</VersionIdMarker>
<NextVersionIdMarker>nextVersionIdMarker</NextVersionIdMarker>
<Delimiter>delimiter</Delimiter>
<Version>
<Key>object1</Key>
<VersionId>versionId</VersionId>
<IsLatest>true</IsLatest>
<LastModified>date</LastModified>
<ETag>etag</ETag>
<Size>size</Size>
<StorageClass>storageClass</StorageClass>
<Owner>
<ID>userId</ID>
<DisplayName>displayName</DisplayName>
</Owner>
<Type>type</Type>
</Version>
...
<DeleteMarker>
<Key>object2</Key>
<VersionId>versionId</VersionId>
<IsLatest>true</IsLatest>
<LastModified>date</LastModified>
<Owner>
<ID>userId</ID>
<DisplayName>displayName</DisplayName>
</Owner>
<Type>Normal</Type>
</DeleteMarker>
...
</ListVersionsResult>响应消息头
该请求的响应消息使用公共的响应消息头,请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| ListVersionsResult | 参数解释: 返回结果的容器。 | Container |
表ListVersionsResult
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| IsTruncated | 参数解释: 列表结果是否被截断。 | Boolean |
| Version | 参数解释: 单个多版本对象信息的容器。 | Container |
| DeleteMarker | 参数解释: 单个多版本对象的delete-maker信息的容器。 | Container |
| KeyMarker | 参数解释: 列举多版本key的起始位置。 | String |
| NextKeyMarker | 参数解释: 若结果被截断,则给出分页所需的KeyMarker。 | String |
| VersionIdMarker | 参数解释: 列举多版本key的版本号的起始位置。 | String |
| NextVersionIdMarker | 参数解释: 若结果被截断,则给出分页所需的VersionIdMarker。 | String |
| Name | 参数解释: Bucket的名称。 | String |
| Prefix | 参数解释: 列出请求时指定的前缀。 | String |
| Delimiter | 参数解释: 列出请求时指定的路径分隔符。 | String |
| MaxKeys | 参数解释: 列出请求时指定的最大记录数。 | Long |
表Version
| 名称 | 描述 | 类型 |
|---|---|---|
| ETag | 参数解释: 对象的Etag。 | String |
| Key | 参数解释: 对象的Key。 | String |
| LastModified | 参数解释: 对象的修改时间。 | Date |
| Owner | 参数解释: 对象所有者信息。 | Container |
| Size | 参数解释: 对象的大小。 | Long |
| StorageClass | 参数解释: 对象的存储级别。 | String |
| IsLatest | 参数解释: 是否是最新版本。 | Boolean |
| VersionId | 参数解释: 对象版本号。 | String |
| Type | 参数解释: 对象类型,普通对象为 Normal,软链接对象为 Symlink。 | String |
表DeleteMarker
| 名称 | 描述 | 类型 |
|---|---|---|
| Key | 参数解释: 对象的Key。 | String |
| LastModified | 参数解释: 对象的修改时间。 | Date |
| Owner | 参数解释: 对象所有者信息。 | Container |
| IsLatest | 参数解释: 是否是最新版本。 | Boolean |
| VersionId | 参数解释: 对象版本号。 | String |
| Type | 参数解释: 对象类型,普通对象为 Normal,软链接对象为 Symlink。 | String |
表Owner
| 名称 | 描述 | 类型 |
|---|---|---|
| DisplayName | 参数解释: 所有者名称。 | String |
| ID | 参数解释: 所有者ID。 | String |
错误码
请参见调用前必知-错误码-全局错误码。