全部产品
Search
文档中心

对象存储 OSS:du(获取大小)

更新时间:Jul 31, 2024

du命令用于获取指定存储空间(Bucket)、文件目录下包含的所有Object的大小。

注意事项

要获取当前版本所有Object的大小,您需要具有oss:ListObjectsoss:ListPartsoss:ListMultipartUploads权限;要获取所有版本Object大小,您需要具有oss:ListObjectVersionsoss:ListPartsoss:ListMultipartUploads权限。具体操作,请参见为RAM用户授权自定义的权限策略

命令格式

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

参数

类型

说明

prefix

string

Bucket下的某个文件目录或指定前缀。

--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

/

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

--human-readable

/

以人类可读方式输出信息。文件大小转成 Ki|Mi|Gi|Ti|Pi 后缀格式。

--include

stringArray

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

--include-from

stringArray

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

--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。

--page-size

int

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

-r, --recursive

/

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

--request-payer

string

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

--start-after

string

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

说明

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

使用示例

  • 查询examplebucket内的文件大小。

    ossutil du oss://examplebucket

    以下输出结果表明examplebucket内共有13个Object,其中12个Object的存储类型为Standard(标准存储),1个Object为Archive(归档存储),Object总大小为132116024字节。

    storage class   object count            sum size
    ----------------------------------------------------------
    Standard        12                       132115210
    Archive         1                        814
    ----------------------------------------------------------
    total object count: 13                          total object sum size: 132116024
    total part count:   0                           total part sum size:   0
    
    total du size:132116024
    
    0.382978(s) elapsed
  • 查询examplebucket内desfolder文件夹的文件大小。

    ossutil du oss://examplebucket/desfolder

    以下输出结果表明examplebucket内共有4个存储类型为Standard(标准存储)的Object,Object总大小为92927字节。

    storage class   object count            sum size
    ----------------------------------------------------------
    Standard        4                       92927
    ----------------------------------------------------------
    total object count: 4                           total object sum size: 92927
    total part count:   0                           total part sum size:   0
    
    total du size:92927
    
    0.350440(s) elapsed
  • 查询examplebucket内desfolder文件夹中包含.jpg后缀的文件大小。

    ossutil du oss://examplebucket/desfolder --include *.jpg

    以下输出结果表明examplebucket内共有1个存储类型为Standard(标准存储)的Object,Object总大小为92884字节。

    storage class   object count            sum size
    ----------------------------------------------------------
    Standard        1                       92884
    ----------------------------------------------------------
    total object count: 1                           total object sum size: 92884
    total part count:   0                           total part sum size:   0
    
    total du size:92884
    
    0.381506(s) elapsed
  • 查询examplebucket内desfolder文件夹的文件大小,输出方式为JSON。

    ossutil du oss://examplebucket/desfolder --output-format json

    以下输出结果表明examplebucket内共有4个存储类型为Standard(标准存储)的Object,Object总大小为92927字节。

    {
      "ObjectCount": 4,
      "ObjectSize": 92927,
      "StandardObjectCount": 4,
      "StandardObjectSize": 92927,
      "Storage": 92927
    }
    0.508607(s) elapsed