list-objects-v2(get-bucket-v2)

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

说明

使用示例

以下示例展示了如何列举存储空间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