S3 列表存储区对象版本

在线编辑

返回有关存储区中所有对象版本的元数据列表。 需要对存储区的读访问权。

将 versions 子资源添加到存储区请求，如下所示。

语法

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

Authorization: AWS _ACCESS_KEY_:_HASH_OF_HEADER_AND_SECRET_

您可以为 GET /_BUCKET_?versions指定参数，但这些参数都不是必需的。

参数

prefix

描述

返回正在进行的上载，这些上载的密钥包含指定的前缀。

类型

字符串

delimiter

描述

前缀与对象名的其余部分之间的定界符。

类型

字符串

key-marker

描述

上载列表的开始标记。

类型

字符串

max-keys

描述

正在进行的上载的最大数目。 缺省值为 1000。

类型

整数

version-id-marker

描述

指定要从列表开始的对象版本。

类型

字符串

响应实体

KeyMarker

描述

key-marker 请求参数指定的键标记 (如果有)。

类型

字符串

NextKeyMarker

描述

要在后续请求中使用的密钥标记 (如果 IsTruncated 为 true)。

类型

字符串

NextUploadIdMarker

描述

要在后续请求中使用的上载标识标记 (如果 IsTruncated 为 true)。

输入
字符串

IsTruncated

描述

如果值为 true，那么仅返回存储区上载内容的子集。

类型

布尔值

Size

描述

已上载部件的大小。

类型

整数

DisplayName

描述

所有者的显示名称。

类型

字符串

ID

描述

所有者的标识。

类型

字符串

Owner

描述

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

类型

容器

StorageClass

描述

用于存储结果对象的方法。 STANDARD 或 REDUCED_REDUNDANCY

类型

字符串

Version

描述

版本信息的容器。

类型

容器

versionId

描述

对象的版本标识。

类型

字符串

versionIdMarker

描述

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

类型

字符串