文档首页 > > 工具指南> obsutil> 对象相关命令>

列举对象

列举对象

分享
更新时间:2021/07/23 GMT+08:00

功能说明

查询桶内对象或多版本对象,返回对象列表将按照对象名和版本号以字典序排列。

命令结构

  • Windows操作系统
    obsutil ls obs://bucket[/prefix] [-s] [-d] [-v] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统
    ./obsutil ls obs://bucket[/prefix] [-s] [-d] [-v] [-marker=xxx] [-versionIdMarker=xxx] [-bf=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

  • 以Windows操作系统为例,运行obsutil ls obs://bucket-test -limit=10,查询桶内对象。
    obsutil ls obs://bucket-test -limit=10
    
    Folder list:
    obs://bucket-test/api/
    
    Object list:
    key                                               LastModified                  Size      StorageClass        ETag                
    obs://bucket-test/AUTHORS                         2018-11-16T02:15:49Z          33243     standard            "796393c1eaf502ef56a85c2ceb640aea"
    
    obs://bucket-test/CONTRIBUTING.md                 2018-11-16T02:15:49Z          1366      standard            "12d93325ba6131f852daecd18dd65edc"
    
    obs://bucket-test/CONTRIBUTORS                    2018-11-16T02:15:49Z          45710     standard            "b486b5003e6215c9199e86ab3ccec9fa"
    
    obs://bucket-test/LICENSE                         2018-11-16T02:15:49Z          1479      standard            "5d4950ecb7b26d2c5e4e7b4e0dd74707"
    
    obs://bucket-test/PATENTS                         2018-11-16T02:15:49Z          1303      standard            "3a55d95595a6f9e37dee53826b4daff2"
    
    obs://bucket-test/README.md                       2018-11-16T02:15:49Z          1399      standard            "97351fd7946b9ea021a31a86ba2a10ab"
    
    obs://bucket-test/VERSION                         2018-11-16T02:15:49Z          7         standard            "43d93b553855b0e1fc67e31c28c07b65"
    
    obs://bucket-test/api/README                      2018-11-16T02:15:49Z          521       standard            "4e9e63a87075df60cdf65c8ce9e92117"
    
    obs://bucket-test/api/except.txt                  2018-11-16T02:15:49Z          20194     standard            "8eb96de3f60447e2f09a7531c99fb3ee"
    
    Next marker is: api/except.txt
    Folder number is: 1
    File number is: 9

参数说明

参数

约束

描述

bucket

必选

桶名。

prefix

可选

列举对象时的对象名前缀。

说明:

如果为空,则表示列举桶内所有对象。

s

附加参数,可选

以精简格式显示查询结果。

说明:

在精简格式下,返回结果只包含对象名。

d

附加参数,可选

仅列举当前目录下的对象和子目录,而非递归列举所有对象和子目录。

说明:

OBS中约定以“/”作为目录分隔符。

v

附加参数,可选

列举桶内多版本对象,列举结果包含最新版本的对象和历史版本的对象(如果有)。

marker

附加参数,可选

列举桶内对象的起始位置,返回结果是对象名按照字典序排序后该参数以后的所有对象。

说明:

请参考列举示例理解该参数的使用方式。

versionIdMarker

附加参数,可选,必须与v和marker配合使用

列举桶内多版本对象的起始位置,返回结果是对象名和版本号按照字典序排序后该参数以后的所有对象。

说明:

如果versionIdMarker不是marker的一个版本号,则该参数无效。

bf

附加参数,可选

列举结果中字节数的显示格式。支持的值:

  • human-readable
  • raw
说明:

如果未设置该参数,则列举结果中字节数的显示格式由配置文件中的humanReadableFormat参数决定。

limit

附加参数,可选

列举结果的最大个数,小于等于0表示列举所有结果,不设置时的默认值为1000。

说明:

如果桶内对象较多,建议设置该值限制每次列举的对象个数,列举结束后,如果仍有对象,会在结果中返回下次请求的marker和versionIdMarker,用于继续列举剩余的对象。

format

附加参数,可选

指定以自定义格式打印列举结果。当前仅支持值[default],指定列举结果在一行显示。

config

附加参数,可选

运行当前命令时的自定义配置文件,可支持的配置参数请参考配置参数说明

e

附加参数,可选

指定终端节点。

i

附加参数,可选

指定用户的AK。

k

附加参数,可选

指定用户的SK。

t

附加参数,可选

指定用户的securitytoken。

分享:

    相关文档

    相关产品