ListObjectVersions_对象存储_API文档-阿里云OpenAPI开发者门户

接口说明

不同 Object 之间按字母排序返回，同一个 Object 的不同版本则按从新到旧排序，与版本 ID 的字母序无关。

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

oss:ListObjectVersions	List	Bucket acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}	acs:UserAgent acs:AccessId oss:BucketTag oss:Prefix oss:Delimiter oss:TLSVersion	oss:GetObject

GET /?versions HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com

字段名称	字段详情
bucketstring	Bucket 名称。示例值:examplebucket
delimiterstring	对 Object 名字进行分组的字符。所有 Object 名字包含指定的前缀（prefix），第一次出现 delimiter 字符之间的 Object 作为一组元素（即 CommonPrefixes）。展开详情示例值:/
key-markerstring	设定结果从 key-marker 之后按字母序开始返回，与 version-id-marker 组合使用。展开详情示例值:example
version-id-markerstring	设定结果从 key-marker 对象的 version-id-marker 之后按新旧版本排序开始返回。如果 version-id-marker 未设定，则默认从 key-marker 按字母序排序的下一个 Key 的第一个版本开始返回。展开详情示例值:CAEQMxiBgICbof2D0BYiIGRhZjgwMzJiMjA3MjQ0ODE5MWYxZDYwMzJlZjU1****
max-keysinteger<int64>	限定此次返回 Object 的最大个数。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:100
prefixstring	限定返回的 Object Key 必须以 prefix 作为前缀。展开详情示例值:fun
encoding-typeEncodeType	指明返回结果中编码使用的类型。如果请求的参数中指定了 encoding-type，那返回的结果会对 Key 进行编码。示例值:URL枚举值:url

字段名称	字段详情
ListVersionsResultobject	保存 GetBucketVersions 请求结果的容器。

	变更时间	变更内容概要	操作
	2024-02-21	变更返回参数