list-object-versions

list-object-versions命令用于列出Bucket中包括删除标记(Delete Marker)在内的所有Object的版本信息。

注意事项

要列出Object的版本信息,您必须有oss:ListObjectVersions权限。具体操作,请参见为RAM用户授权自定义的权限策略

命令格式

ossutil api list-object-versions --bucket value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--delimiter

string

对Object名字进行分组的字符。

--encoding-type

string

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

--key-marker

string

设定结果从key-marker之后按字母序开始返回,与version-id-marker组合使用。

--max-keys

int

限定此次返回Object的最大个数。

--prefix

string

限定返回的Object Key必须以prefix作为前缀。

--version-id-marker

string

设定结果从key-marker对象的version-id-marker之后按新旧版本排序开始返回。

说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

  • 列举存储空间examplebucket中所有Object的版本信息。

    ossutil api list-object-versions --bucket examplebucket
  • 列举存储空间examplebucket中所有Object的版本信息,以JSON格式显示。

    ossutil api list-object-versions --bucket examplebucket --output-format json
  • 列举存储空间examplebucket中所有Object的版本信息,以YAML格式显示。

    ossutil api list-object-versions --bucket examplebucket --output-format yaml
  • 列举存储空间examplebucket下,指定前缀dir下的所有Object的版本信息。

    ossutil api list-object-versions --bucket examplebucket --prefix dir
  • 列举存储空间examplebucket下,指定前缀dir下,前100个Object的版本信息。

    ossutil api list-object-versions --bucket examplebucket --prefix dir --max-keys 100
  • 列举存储空间examplebucket下,当前目录下的所有Object的版本信息。

    ossutil api list-object-versions --bucket examplebucket --delimiter /
  • 列举存储空间examplebucket下,从test.txt之后的所有Object的版本信息。

    ossutil api list-object-versions --bucket examplebucket --key-marker test.txt
  • 列举存储空间examplebucket中所有Object的版本信息,并对对象名字进行URL编码。

    ossutil api list-object-versions --bucket examplebucket --encoding-type url
  • 列举存储空间examplebucket下,从test.txt对象的123版本之后的所有Object的版本信息。

    ossutil api list-object-versions --bucket examplebucket --key-marker test.txt --version-id-marker 123