list-objects-v2命令用于列举存储空间(Bucket)中所有文件(Object)的信息。
注意事项
阿里云账号默认拥有列举Bucket中的所有文件的信息。如果您需要通过RAM用户或者STS的方式进行查看,您必须拥有
oss:ListObjects
权限。具体操作,请参见为RAM用户授权自定义的权限策略。执行list-objects-v2(get-bucket-v2)请求时不会返回Object中自定义的元信息。
命令格式
ossutil api list-objects-v2 --bucket value [flags]
参数 | 类型 | 说明 |
--bucket | string | Bucket的名称。 |
--continuation-token | string | 指定list操作需要从此token开始。 |
--delimiter | string | 对Object名字进行分组的字符。 |
--encoding-type | string | 对返回的内容进行编码并指定编码的类型。 |
--fetch-owner | string | 指定是否在返回结果中包含owner信息。 |
--max-keys | int | 指定返回Object的最大数。 |
--prefix | string | 限定返回文件的Key必须以Prefix作为前缀。 |
--start-after | string | 设定从Start-after之后按字母排序开始返回Object |
list-objects-v2(get-bucket-v2)命令对应API接口ListObjectsV2(GetBucketV2)。关于API中的具体参数含义,请参见ListObjectsV2(GetBucketV2)。
关于支持的全局命令行选项,请参见支持的全局命令行选项。
使用示例
以下示例展示了如何列举存储空间examplebucket
中所有Object
的信息。
ossutil api list-objects-v2 --bucket examplebucket
以下示例展示了如何列举存储空间examplebucket
中所有Object
的信息,以JSON格式显示。
ossutil api list-objects-v2 --bucket examplebucket --output-format json
以下示例展示了如何列举存储空间examplebucke
中所有Object
的信息,以YAML格式显示。
ossutil api list-objects-v2 --bucket examplebucket --output-format yaml
以下示例展示了如何列举存储空间examplebucket
中指定前缀dir
下的所有Object
的信息。
ossutil api list-objects-v2 --bucket examplebucket --prefix dir
以下示例展示了如何列举存储空间examplebucket
中指定前缀dir
下,前100个Object
的信息。
ossutil api list-objects-v2 --bucket examplebucket --prefix dir --max-keys 100
以下示例展示了如何列举存储空间examplebucket
中当前目录下的Object
的信息。
ossutil api list-objects-v2 --bucket examplebucket --delimiter/
以下示例展示了如何列举存储空间examplebucket
中指从test.txt
之后的Object
的信息。
ossutil api list-objects-v2 --bucket examplebucket --marker test.txt
以下示例展示了如何列举存储空间examplebucket
中所有Object
的信息,并对Object
的名字进行URL编码。
ossutil api list-objects-v2 --bucket examplebucket --encoding-type url
以下示例展示了如何列举存储空间examplebucket
中所有Object
的信息,并返回结果中包含owner信息。
ossutil api list-objects-v2 --bucket examplebucket --fetch-owner
以下示例展示了如何列举存储空间examplebucket
中,从CgJiYw123
开始的所有Object
的信息。
ossutil api list-objects-v2 --bucket examplebucket --continuation-token CgJiYw123