文档首页/ 对象存储服务 OBS/ 工具指南/ obsutil/ 桶相关命令/ 列举桶
更新时间：2024-12-11 GMT+08:00
查看PDF
分享

列举桶

功能说明

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

命令结构

  • Windows操作系统 
    obsutil ls [-s] [-fs] [-sc] [-du] [-fs] [-j=1] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统 
    ./obsutil ls [-s] [-fs] [-sc] [-du] [-fs] [-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
Start at 2024-09-29 07:58:46.0506904 +0000 UTC

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代表并行文件系统。

父主题： 桶相关命令

相关文档