更新时间：2025-08-13 GMT+08:00
列举桶
您可以通过列举桶查看已创建的桶列表。
注意事项
列举桶请求默认发生在华北-北京一，所以在统计请求费用时，ListAllMyBucketsOperation请求的费用会被划归到华北-北京一区域。
使用方式
OBS支持通过控制台、API、SDK、OBS Browser+、obsutil方式列举桶。
使用命令行工具obsutil
命令结构
- 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 |
附加参数，可选 |
是否使用并行文件系统的列举方式，如果桶是并行文件系统，推荐加上该参数。
注意：
|
|
limit |
附加参数，可选 |
查询桶的最大个数，小于0表示列举所有结果，不设置时的默认值为1000。 |
|
format |
附加参数，可选 |
指定以自定义格式打印列举结果。当前仅支持值[default]，指定列举结果在一行显示。 |
|
config |
附加参数，可选 |
运行当前命令时的自定义配置文件，可支持的配置参数请参考 |
|
e |
附加参数，可选 |
指定终端节点。 |
|
i |
附加参数，可选 |
指定用户的AK。 |
|
k |
附加参数，可选 |
指定用户的SK。 |
|
t |
附加参数，可选 |
指定用户的securitytoken。 |
列举桶的结果中，BucketType字段表示桶的类型，OBJECT代表对象桶；POSIX代表并行文件系统。
