更新时间:2023-03-16 GMT+08:00

列举桶

功能说明

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

命令结构

  • Windows操作系统
    obsutil ls [-s] [-du] [-sc] [-j=1] [-limit=1] [-format=default] [-config=xxx] 
  • macOS/Linux操作系统
    ./obsutil ls [-s] [-du] [-sc] [-j=1] [-limit=1] [-format=default] [-config=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

附加参数,可选

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

说明:

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

limit

附加参数,可选

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

format

附加参数,可选

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

config

附加参数,可选

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

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