您可以通过API级命令列举存储空间(Bucket)中所有文件(Object)的信息。
注意事项
要列举Bucket中的所有Object信息,您必须有
oss:ListObjects
权限。具体操作,请参见为RAM用户授权自定义的权限策略。执行该请求时不会返回Object中自定义的元数据。
命令格式
ossutil api list-objects --bucket value [flags]
参数 | 类型 | 说明 |
--bucket | string | Bucket名称。 |
--delimiter | string | 对Object名字进行分组的字符。 |
--encoding-type | string | 对返回的内容进行编码并指定编码的类型。 |
--marker | string | 设定从marker之后按字母排序开始返回Object。 |
--max-keys | int | 指定返回Object的最大个数。 |
--prefix | string | 限定返回文件的Key必须以Prefix作为前缀。 |
说明
关于支持的全局命令行选项,请参见支持的全局命令行选项。
使用示例
列举存储空间examplebucket中所有Object的信息。
ossutil api list-objects --bucket examplebucket
列举存储空间examplebucket中所有Object的信息,输出格式为JSON。
ossutil api list-objects --bucket examplebucket --output-format json
列举存储空间examplebucket中所有Object的信息,输出格式为YAML。
ossutil api list-objects --bucket examplebucket --output-format yaml
列举存储空间examplebucket下,指定前缀dir下的所有Object的信息。
ossutil api list-objects --bucket examplebucket --prefix dir
列举存储空间examplebucket下,指定前缀dir下,前100个Object的信息。
ossutil api list-objects --bucket examplebucket --prefix dir --max-keys 100
列举存储空间examplebucket下,当前目录下的Object的信息。
ossutil api list-objects --bucket examplebucket --delimiter /
列举存储空间examplebucket下,从test.txt之后的Object的信息。
ossutil api list-objects --bucket examplebucket --marker test.txt
列举存储空间examplebucket中所有Object的信息,并对对象名字进行URL编码。
ossutil api list-objects --bucket examplebucket --encoding-type url
文档内容是否对您有帮助?