# 列举桶 当账户下桶的数量比较多时，人工管理桶不仅效率低下，且容易发生操作失误。用户可以通过**列举桶**功能，获取账户下的桶列表，从而方便进行桶清点、批量操作、权限审计等操作，从而提升管理桶的效率与准确性。 #### 注意事项 列举桶请求默认发生在华北-北京一，所以在统计[请求费用](https://support.huaweicloud.com/price-obs/obs_42_0004.html)时，ListAllMyBucketsOperation请求的费用会被划归到华北-北京一区域。同时列举桶列表后可能涉及数据信息的传输，从而产生流量，具体流量计费说明请参见[流量计费](https://support.huaweicloud.com/price-obs/obs_42_0005.html)。 #### 约束限制 列举账号下所有桶需要拥有obs:bucket:ListAllMyBuckets权限，授权资源选择所有桶，您可以使用IAM进行授权，配置方式详见[使用IAM自定义策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0121.html)，授权示例如下： ``` { "Version": "5.0", "Statement": [ { "Effect": "Allow", "Action": [ "obs:bucket:ListAllMyBuckets" ], "Resource": [ "obs:*:*:bucket:*" ] } ] } ``` ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) ListAllMyBuckets属高危权限，容易导致桶名泄露风险，请谨慎操作。 #### 使用方式 OBS支持通过[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)、API、SDK、OBS Browser+、obsutil方式列举桶。 #### 使用OBS控制台 1. 在OBS[管理控制台](https://console.huaweicloud.com/console/?locale=zh-cn#/obs/manager/buckets)左侧导航栏选择"桶列表"。 2. 进入桶列表页，桶列表页展示账户下所有的桶。 #### 使用API [列举桶](https://support.huaweicloud.com/api-obs/obs_04_0020.html) #### 使用SDK | [Java](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0402.html) | [Python](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0802.html) | [C](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0302.html) | [Go](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0403.html) | BrowserJS不支持列举桶。 | [.NET](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0302.html) | [Android](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0302.html) | [iOS](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0302.html) | [PHP](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0302.html) | [Node.js](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0302.html) | |---|---|---|---|---|---|---|---|---|---| #### 使用图形化工具OBS Browser+ [登录OBS Browser+](https://support.huaweicloud.com/browsertg-obs/obs_03_1004.html)，桶列表页将展示账户下所有的桶。 #### 使用命令行工具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值，统计桶或者并行文件系统或者指定目录的大小。 - obsutil 5.5.12版本及以上支持该参数。 | | limit | 附加参数，可选 | 查询桶的最大个数，小于0表示列举所有结果，不设置时的默认值为1000。 | | format | 附加参数，可选 | 指定以自定义格式打印列举结果。当前仅支持值\[default\]，指定列举结果在一行显示。 | | config | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 | | e | 附加参数，可选 | 指定终端节点。 | | i | 附加参数，可选 | 指定用户的AK。 | | k | 附加参数，可选 | 指定用户的SK。 | | t | 附加参数，可选 | 指定用户的securitytoken。 | ![](https://support.huaweicloud.com/usermanual-obs/public_sys-resources/note_3.0-zh-cn.png) 列举桶的结果中，BucketType字段表示桶的类型，OBJECT代表对象桶；POSIX代表并行文件系统。 #### 日志与监控 为帮助用户及时感知并处理删除操作，OBS提供了从实时感知到事后审计的完整管控能力。用户可以通过CTS追踪列举桶的事件操作（listAllMyBuckets）以及OBS获取桶列表的operation（REST.GET.SERVICE）来监控列举桶操作的详细日志，供用户审计或进一步分析。了解配置日志监控相关操作，请参见[监控与日志](https://support.huaweicloud.com/usermanual-obs/obs_03_0731.html)。