列举桶

您可以通过列举桶查看已创建的桶列表。

注意事项

列举桶请求默认发生在华北-北京一，所以在统计请求费用时，ListAllMyBucketsOperation请求的费用会被划归到华北-北京一区域。

约束限制

列举账号下所有桶需要拥有obs:bucket:ListAllMyBuckets权限，授权资源选择所有桶，您可以使用IAM进行授权，配置方式详见使用IAM自定义策略，授权示例如下：

     
          {
    "Version": "5.0",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "obs:bucket:ListAllMyBuckets"
            ],
            "Resource": [
                "obs:*:*:bucket:*"
            ]
        }
    ]
}

使用方式

OBS支持通过管理控制台、API、SDK、OBS Browser+、obsutil方式列举桶。

使用OBS控制台

登录OBS管理控制台。
进入桶列表页，桶列表页展示账户下所有的桶。

使用API

列举桶

使用SDK

BrowserJS不支持列举桶。

使用图形化工具OBS Browser+

登录OBS Browser+，桶列表页将展示账户下所有的桶。

使用命令行工具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	附加参数，可选	是否使用并行文件系统的列举方式，如果桶是并行文件系统，推荐加上该参数。注意：该列举方式会因为目录结构，耗时会差别很大。该参数开启后，会忽略marker和limit值，统计桶或者并行文件系统或者指定目录的大小。 Util 5.5.12版本及以上支持该参数。
limit	附加参数，可选	查询桶的最大个数，小于0表示列举所有结果，不设置时的默认值为1000。
format	附加参数，可选	指定以自定义格式打印列举结果。当前仅支持值[default]，指定列举结果在一行显示。
config	附加参数，可选	运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明。
e	附加参数，可选	指定终端节点。
i	附加参数，可选	指定用户的AK。
k	附加参数，可选	指定用户的SK。
t	附加参数，可选	指定用户的securitytoken。