赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. 常用工具
  6. 命令行工具ossutil 2.0
  7. ossutil命令
  8. API级命令
  9. 关于Bucket操作
  10. 版本控制(Versioning)
  11. list-object-versions

list-object-versions

  • 版本控制(Versioning)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

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
相关文章

put-bucket-versioning 2025-04-21 17:28

put-bucket-versioning命令用于设置指定存储空间(Bucket)的版本控制状态。 注意事项

get-bucket-versioning 2025-04-21 17:28

get-bucket-versioning命令用于获取指定Bucket的版本控制状态。 注意事项 要获取指定Bucket的版本控制状态,您必须有oss:GetBucketVersioning

list-object-versions 2025-04-21 17:28

list-object-versions命令用于列出Bucket中包括删除标记(Delete Marker)在内的所有Object的版本信息。 注意事项 要列出Object的版本信息,您必须有os

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号