Todos os produtos
Search
Central de documentação

Object Storage Service:du

Última atualização: Jul 03, 2026

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

Observações de uso

A consulta do tamanho de objetos da versão atual exige as permissões oss:ListObjects, oss:ListParts e oss:ListMultipartUploads. Para consultar o tamanho de todas as versões, são necessárias as permissões oss:ListObjectVersions, oss:ListParts e oss:ListMultipartUploads. Para mais informações, consulte Conceder uma política personalizada.

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

prefix

string

Diretório do objeto ou prefixo do nome.

--all-versions

/

Consulta o tamanho total de todas as versões dos objetos especificados.

-d, --dirs

/

Lista objetos e subdiretórios no diretório atual.

--encoding-type

string

Método de codificação para nomes de objetos. Valor válido: url.

--end-with

string

Retorna objetos cujos nomes sejam alfabeticamente anteriores ou iguais ao valor especificado.

--exclude

stringArray

Regra de exclusão para o caminho ou nome do objeto.

--exclude-from

stringArray

Lê regras de exclusão de um arquivo de regras.

--files-from

stringArray

Lê nomes de objetos de um arquivo de regras. Linhas vazias e comentários são ignorados.

--files-from-raw

stringArray

Lê nomes de objetos de um arquivo de regras.

--filter

stringArray

Regra de filtro para o caminho ou nome do objeto.

--filter-from

stringArray

Lê regras de filtro de um arquivo de regras.

-f, --force

/

Executa o comando sem solicitar confirmação.

--human-readable

/

Exibe o tamanho dos objetos em unidades legíveis: KiB, MiB, GiB, TiB ou PiB.

--include

stringArray

Regra de inclusão para o caminho ou nome do objeto.

--include-from

stringArray

Lê regras de inclusão de um arquivo de regras.

--list-objects

/

Usa a operação ListObjects para listar objetos.

--max-size

SizeSuffix

Tamanho máximo do objeto a incluir. Unidade padrão: bytes. Unidades compatíveis: bytes, KiB, MiB, GiB, TiB, PiB. 1 KiB = 1024 bytes.

--metadata-exclude

stringArray

Regra de exclusão para metadados do objeto.

--metadata-filter

stringArray

Regra de filtro para metadados do objeto.

--metadata-filter-from

stringArray

Lê regras de filtro de metadados de um arquivo de regras.

--metadata-include

stringArray

Regra de inclusão para metadados do objeto.

--min-age

Duration

Exclui objetos modificados há menos tempo que a duração especificada. Unidade padrão: segundos. Exemplo: 1h para uma hora.

Nota

--min-age 1h consulta apenas objetos modificados há uma hora ou mais.

--max-age

Duration

Inclui apenas objetos modificados dentro da duração especificada. Unidade padrão: segundos. Exemplo: 1h para uma hora.

Nota

--max-age 1h consulta apenas objetos modificados na última hora.

--min-mtime

Time

Inclui apenas objetos modificados após o horário UTC especificado. Exemplo: 2006-01-02T15:04:05.

Nota

--min-mtime "2006-01-02T15:04:05" consulta apenas objetos modificados após as 15:04:05 de 2 de janeiro de 2006.

--max-mtime

Time

Inclui apenas objetos modificados antes do horário UTC especificado. Exemplo: 2006-01-02T15:04:05.

--min-size

SizeSuffix

Tamanho mínimo do objeto a incluir. Unidade padrão: bytes. Unidades compatíveis: bytes, KiB, MiB, GiB, TiB, PiB. 1 KiB = 1024 bytes.

--page-size

int

Número máximo de objetos retornados por página na listagem paginada. Valores válidos: 1 a 1000. Padrão: 1000.

-r, --recursive

/

Executa o comando recursivamente em todos os objetos correspondentes no bucket. Sem essa flag, o sistema processa apenas os objetos no caminho especificado.

--request-payer

string

Pagador da solicitação. Defina como requester se o pagamento pelo solicitante estiver ativado para o bucket.

--start-after

string

Retorna objetos cujos nomes sejam alfabeticamente posteriores ao valor especificado.

Nota

Para mais informações, consulte Opções de linha de comando.

Exemplos

  • Consultar o tamanho total de objetos em um bucket

    ossutil du oss://examplebucket

    A saída mostra 13 objetos (12 Standard, 1 Archive) com um total de 132116024 bytes.

    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
  • Consultar o tamanho total de objetos em um diretório

    ossutil du oss://examplebucket/desfolder

    A saída indica 4 objetos Standard com um total de 92927 bytes no diretório desfolder.

    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
  • Consultar o tamanho total de objetos .jpg em um diretório

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

    O resultado apresenta 1 objeto .jpg Standard com um total de 92884 bytes.

    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
  • Consultar o tamanho total de objetos com saída em formato JSON

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

    A resposta exibe 4 objetos Standard com um total de 92927 bytes no formato JSON.

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