2.4.22. S3 列表存储桶对象版本


返回存储桶中所有对象版本的元数据列表。需要指向存储桶的 READ 访问权限。

将 version 子资源添加到存储桶请求,如下所示。

语法

GET /BUCKET?versions HTTP/1.1
Host: cname.domain.com

Authorization: AWS ACCESS_KEY:HASH_OF_HEADER_AND_SECRET

您可以为 GET /BUCKET?version 指定参数,但不需要它们。

表 2.15. 参数
名称Type描述

prefix

字符串

返回的 in-progress 上传,其密钥包含指定前缀。

delimiter

字符串

前缀与其他对象名称之间的分隔符。

key-marker

字符串

上传列表的开头标记。

max-keys

整数

上传的最大 in-progres 数。默认值为 1000。

version-id-marker

字符串

指定用于开始列表的对象版本。

表 2.16. 响应实体
名称Type描述

KeyMarker

字符串

通过密钥标记请求参数指定的 密钥标记 (如果有)。

NextKeyMarker

字符串

如果 IsTruncated 为 true,则后续请求中使用的密钥标记。

NextUploadIdMarker

字符串

如果 IsTruncated 为 true,则上传 ID 标记用于后续请求。

IsTruncated

布尔值

如果为 true,则仅返回存储桶上传内容的子集。

大小

整数

上传部分的大小。

DisplayName

字符串

所有者的显示名称。

ID

字符串

所有者的 ID。

所有者

Container

用于拥有对象的用户的 ID 和 DisplayName 的容器。

StorageClass

字符串

用于存储生成的对象的方法。STANDARD 或 REDUCED_REDUNDANCY

版本

Container

版本信息的容器。

versionId

字符串

对象的版本 ID。

versionIdMarker

字符串

已截断响应中密钥的最后一个版本。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部