列举桶
功能说明
获取桶列表,查询到的桶列表将以桶名字典序排列。
命令结构
- 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 | 附加参数,可选 | 是否使用并行文件系统的列举方式,如果桶是并行文件系统,推荐加上该参数。 注意:
|
| format | 附加参数,可选 | 指定以自定义格式打印列举结果。当前仅支持值[default],指定列举结果在一行显示。 |
| config | 附加参数,可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考配置参数说明。 |
| e | 附加参数,可选 | 指定终端节点。 |
| i | 附加参数,可选 | 指定用户的AK。 |
| k | 附加参数,可选 | 指定用户的SK。 |
| t | 附加参数,可选 | 指定用户的securitytoken。 |
列举桶的结果中,BucketType字段表示桶的类型,OBJECT代表对象桶;POSIX代表并行文件系统。