更新时间:2024-02-18 GMT+08:00

列举桶

功能说明

获取桶列表,查询到的桶列表将以桶名字典序排列。

命令结构

  • Windows操作系统
    obsutil ls [-s] [-du] [-sc] [-j=1] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统
    ./obsutil ls [-s] [-du] [-sc] [-j=1] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

  • 以Windows操作系统为例,运行obsutil ls -limit=5,查询桶列表。
    obsutil ls -limit=5
    
    Bucket                        CreationDate                  Location         BucketType   
    obs://bucket001               2018-09-03T01:53:02Z          example          OBJECT   
    
    obs://bucket002               2018-11-01T01:40:01Z          example          OBJECT      
    
    obs://bucket003               2018-10-25T11:45:45Z          example          OBJECT       
    
    obs://bucket004               2018-10-26T02:33:09Z          example          OBJECT      
    
    obs://bucket005               2018-10-26T02:34:50Z          example          OBJECT      
             
    Bucket number : 5

参数说明

参数

约束

描述

s

附加参数,可选

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

说明:

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

sc

附加参数,可选

查询桶列表时同时查询桶的存储类型。

j

附加参数,可选,必须与sc参数搭配使用才有意义

查询桶存储类型时的最大并发数,默认为配置文件中的defaultJobs。

说明:

工具会保证该值至少为1。

du

附加参数,可选

快速返回所列举对象的总大小,不显示具体的对象信息,可与其他参数配合使用。

说明:

此参数在列举桶时无效,仅在列举对象时生效。

fs

附加参数,可选

是否使用并行文件系统的列举方式,如果桶是并行文件系统,推荐加上该参数。

注意:
  • 该列举方式会因为目录结构,耗时会差别很大。
  • 该参数开启后,会忽略marker和limit值,统计桶或者并行文件系统或者指定目录的大小。
  • Util 5.5.12版本及以上支持该参数。

limit

附加参数,可选

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

format

附加参数,可选

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

config

附加参数,可选

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

e

附加参数,可选

指定终端节点。

i

附加参数,可选

指定用户的AK。

k

附加参数,可选

指定用户的SK。

t

附加参数,可选

指定用户的securitytoken。

列举桶的结果中,BucketType字段表示桶的类型,OBJECT代表对象桶;POSIX代表并行文件系统。