# 列举桶
#### 功能说明
获取存储桶列表，返回的结果将按存储桶名称的**字典序**进行排列。
#### 命令结构
- 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/utiltg-obs/public_sys-resources/note_3.0-zh-cn.png)
列举桶的结果中，BucketType字段表示桶的类型，OBJECT代表对象桶；POSIX代表并行文件系统。