列举桶
当账户下桶的数量比较多时，人工管理桶不仅效率低下，且容易发生操作失误。用户可以通过列举桶功能，获取账户下的桶列表，从而方便进行桶清点、批量操作、权限审计等操作，从而提升管理桶的效率与准确性。
注意事项
列举桶请求默认发生在华北-北京一，所以在统计请求费用时，ListAllMyBucketsOperation请求的费用会被划归到华北-北京一区域。同时列举桶列表后可能涉及数据信息的传输，从而产生流量，具体流量计费说明请参见流量计费。
约束限制
列举账号下所有桶需要拥有obs:bucket:ListAllMyBuckets权限，授权资源选择所有桶，您可以使用IAM进行授权，配置方式详见使用IAM自定义策略，授权示例如下：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | {
"Version": "5.0",
"Statement": [
{
"Effect": "Allow",
"Action": [
"obs:bucket:ListAllMyBuckets"
],
"Resource": [
"obs:*:*:bucket:*"
]
}
]
}
|
ListAllMyBuckets属高危权限，容易导致桶名泄露风险，请谨慎操作。
使用方式
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代表并行文件系统。
日志与监控
为帮助用户及时感知并处理删除操作，OBS提供了从实时感知到事后审计的完整管控能力。用户可以通过CTS追踪列举桶的事件操作（listAllMyBuckets）以及OBS获取桶列表的operation（REST.GET.SERVICE）来监控列举桶操作的详细日志，供用户审计或进一步分析。了解配置日志监控相关操作，请参见监控与日志。
