Todos os produtos
Search
Central de documentação

Object Storage Service:du

Última atualização: Sep 22, 2026

O comando du consulta o tamanho total de todos os objetos dentro de um bucket ou diretório.

Notas de uso

  • Para consultar o tamanho total de todas as versões atuais dos objetos em um bucket ou diretório, é necessário ter as permissões oss:ListObjects, oss:ListParts e oss:ListMultipartUploads. Já para consultar o tamanho total de todas as versões dos objetos em um bucket ou diretório, são necessárias as permissões oss:ListObjectVersions, oss:ListParts e oss:ListMultipartUploads. Para mais informações, consulte Grant a custom policy.

  • A partir do ossutil 1.6.16, use diretamente ossutil como nome do binário na linha de comando e não atualize o nome do binário com base no sistema operacional. Para versões do ossutil anteriores à 1.6.16, especifique um nome de binário que corresponda ao sistema operacional. Para mais informações, consulte ossutil command reference.

Sintaxe do comando

ossutil du oss://bucketname[/prefix] [--payer requester] [--all-versions][--block-size <value>]

A tabela a seguir descreve os parâmetros e opções na sintaxe do comando.

Parâmetro/Opção

Descrição

bucketname

O nome do bucket.

prefix

O diretório ou prefixo nos nomes dos objetos.

--payer

O pagador da solicitação. Se você deseja que o solicitante que acessa os recursos no caminho especificado pague pelo tráfego e pela solicitação, defina esta opção como requester.

--all-versions

Indica que o comando deve consultar o tamanho total de todas as versões dos objetos. Caso não especifique esta opção, o sistema consulta apenas o tamanho total das versões atuais dos objetos.

--block-size

Define a unidade de medida para o tamanho total dos objetos no bucket ou diretório especificado. Valores válidos: KB, MB, GB e TB. Se você não especificar esta opção, o tamanho dos objetos será medido em bytes.

Importante

Esta opção está disponível para o ossutil 1.7.3 e versões posteriores.

Consultar o tamanho total de todas as versões dos objetos em um bucket

Execute o seguinte comando de exemplo para consultar o tamanho total de todas as versões dos objetos no bucket examplebucket:

ossutil du oss://examplebucket --all-versions

A saída de exemplo a seguir mostra que o bucket contém um total de 13 objetos (12 objetos Standard e 1 objeto Archive), cujo tamanho total é de 132.116.024 bytes.

storage class   object count            sum size(byte)
----------------------------------------------------------
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(byte):132116024

0.382978(s) elapsed

Consultar o tamanho total das versões atuais dos objetos em um diretório

Execute o seguinte comando de exemplo para consultar o tamanho total das versões atuais dos objetos no diretório dir em um bucket chamado examplebucket. O tamanho obtido é medido em GB.

ossutil du oss://examplebucket/dir/  --block-size GB

A saída de exemplo a seguir mostra que o diretório dir no bucket contém um total de 5 objetos Standard, cujo tamanho total é de 0,0002 GB.

storage class   object count            sum size(byte)
----------------------------------------------------------
Standard        5                       232277
----------------------------------------------------------
total object count: 5                           total object sum size: 232277
total part count:   0                           total part sum size:   0

total du size(GB):0.0002

0.078757(s) elapsed

Consultar o tamanho total de todas as versões dos objetos cujos nomes contêm um prefixo específico

Execute o seguinte comando para consultar o tamanho total de todas as versões dos objetos cujos nomes contêm o prefixo test em um bucket chamado examplebucket. O tamanho obtido é medido em KB.

ossutil du oss://examplebucket/test --all-versions --block-size KB

A saída de exemplo a seguir mostra que 4 objetos Standard cujos nomes contêm o prefixo test estão armazenados no bucket examplebucket e que o tamanho total desses objetos é de 448,1455 KB.

storage class   object count            sum size(byte)
----------------------------------------------------------
Standard        4                       439425
----------------------------------------------------------
total object count: 4                           total object sum size: 439425
total part count:   0                           total part sum size:   0

total du size(KB):448.1455

0.126340(s) elapsed

Opções comuns

Para acessar um bucket em uma região diferente, especifique o endpoint usando -e. Para acessar um bucket pertencente a uma conta Alibaba Cloud diferente, use -i para o AccessKeyID e -k para o AccessKeySecret.

Por exemplo, execute o seguinte comando para consultar o tamanho total de todas as versões dos objetos em um bucket chamado testbucket, que está localizado na região China (Shanghai) e pertence a outra conta Alibaba Cloud:

ossutil du oss://testbucket --all-versions -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Common options.