ls(列举账号级别下的资源)

当您需要对账号下的OSS资源进行查询并管理时,例如查询并删除占用空间比较大的文件,您可以通过ls命令列举当前账号下的存储空间(Bucket)、对象(Object)和碎片(Part)信息。

注意事项

  • 要列举Bucket,您必须具有oss:ListBuckets权限;要列举Object,您必须具有oss:ListObjects权限;要列举Object的所有版本,您必须具有oss:ListObjectVersions权限;要列举所有Part,您必须具有oss:ListPartsoss:ListMultipartUploads权限。具体操作,请参见为RAM用户授权自定义的权限策略

命令格式

ossutil ls [oss://bucket[/prefix]] [flags]

局部选项

类型

说明

--all-versions

/

表示对象的所有版本。

-d, --dirs

/

返回当前目录下的文件和子目录,而非递归显示所有子目录下的所有文件。

--encoding-type

string

输入的对象名或文件名的编码方式,取值:url。

--end-with

string

按字母排序,返回设定值之前的对象。

--exclude

stringArray

路径或文件名的排除规则。

--exclude-from

stringArray

从规则文件里读取排除规则。

--files-from

stringArray

从文件中读取源文件名列表,忽略空行或注释行。

--files-from-raw

stringArray

从文件中读取源文件名列表。

--filter

stringArray

路径或文件名过滤规则。

--filter-from

stringArray

从规则文件读取过滤规则。

-f, --force

/

强制操作,不进行询问提示。

--include

stringArray

路径或文件名的包含规则。

--include-from

stringArray

从规则文件里读取包含规则。

--limited-num

int

返回结果的最大个数。

--list-objects

/

使用ListObjects接口列举对象。

--max-age

Duration

不传输任何比此更早的文件。默认是秒,或单位后缀形式 ms|s|m|h|d|w|M|y(默认值off)。

--max-mtime

Time

不传输任何比此更新的文件,UTC时间格式(默认值off)。

--max-size

SizeSuffix

限制传输的最大文件大小,默认是字节,或单位后缀形式B|K|M|G|T|P,1K(KiB)=1024B。

--metadata-exclude

stringArray

对象元数据的排除规则。

--metadata-filter

stringArray

对象元数据过滤规则。

--metadata-filter-from

stringArray

从规则文件读取对象元数据过滤规则。

--metadata-include

stringArray

对象元数据的包含规则。

--min-age

Duration

不传输任何比此更新的文件,默认是秒,或单位后缀形式 ms|s|m|h|d|w|M|y(默认值off)。

--min-mtime

Time

不传输任何比此更早的文件,UTC时间格式 (默认值off)。

--min-size

SizeSuffix

限制传输的最小文件大小,默认是字节,或单位后缀形式B|K|M|G|T|P,1K(KiB)=1024B。

--multipart

/

指定操作的对象为存储空间中未完成的分片事件。

--page-size

int

返回对象或文件的最大数(默认值1000),取值范围1~1000。

-r, --recursive

/

递归进行操作。当指定该选项时,命令会对存储空间下所有符合条件的对象进行操作, 否则只对路径指定的对象进行操作。

--request-payer

string

请求的支付方式,如果为请求者付费模式,请设置该值。取值:requester。

--short-format

/

显示精简格式,如果未指定该选项,默认显示长格式。

--start-after

string

按字母排序,返回设定值之后的对象。

说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

  • 列举所有存储空间。

    ossutil ls
  • 列举存储空间examplebucket下的所有对象。

    ossutil ls oss://examplebucket
  • 列举存储空间examplebucket下,指定前缀dir下的所有对象。

    ossutil ls oss://examplebucket/dir
  • 列举存储空间examplebucket下,指定前缀dir、当前目录下的所有对象。

    ossutil ls oss://examplebucket/dir -d
  • 列举存储空间examplebucket下,指定前缀下dir, 前100个对象。

    ossutil ls oss://examplebucket/dir --limited-num 100
  • 列举存储空间examplebucket下,根目录dir1和dir2下的所有后缀为.txt的文件。

    ossutil ls oss://examplebucket/ --include "/dir1/**.txt" --include "/dir2/**.txt"
  • 列举存储空间examplebucket下, 根目录dir1和dir2目录最近三天生成的所有文件。

    ossutil ls oss://examplebucket --include "/dir1/**" --include "/dir2/**" --max-age 3d
  • 列举所有存储空间,按照JSON格式输出。

    ossutil ls --output-format json