ListObjectVersions
列出Bucket中包括删除标记（Delete Marker）在内的所有Object的版本信息
服务地址：
华东1 金融云
输入参数
只看必填
bucketBucket名称
delimiter对Object名字进行分组的字符
key-marker设定结果从key-marker之后按字...
version-id-marker设定结果从key-marker对象的v...
max-keys限定此次返回Object的最大个数
prefix限定返回的Object Key必须以p...
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • GetBucket(ListObjects)接口仅返回 Object 的当前版本，且当前版本不能为删除标记。
  • GetBucketVersions(ListObjectVersions)接口返回 Bucket 中所有 Object 的所有版本。

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

请求语法

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

对返回的内容进行编码并指定编码类型。展开详情

返回参数

字段名称字段详情
ListVersionsResultobject

保存 GetBucketVersions 请求结果的容器。

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