Todos os produtos
Search
Central de documentação

Object Storage Service:ls (listar recursos no nível da conta)

Última atualização: Sep 09, 2026

Use o comando ls para listar informações sobre buckets, objetos e partes de upload multipart. Esse comando é útil para consultar e gerenciar recursos do Object Storage Service (OSS), como localizar e excluir arquivos grandes para liberar espaço de armazenamento.

Pré-requisitos

Para executar operações de listagem, são necessárias as seguintes permissões do Resource Access Management (RAM):

  • Listar buckets: oss:ListBuckets

  • Listar objetos: oss:ListObjects

  • Listar versões de objetos: oss:ListObjectVersions

  • Listar partes: oss:ListParts e oss:ListMultipartUploads

Para mais informações, consulte Grant a custom policy.

Sintaxe

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

Opção

Tipo

Descrição

--all-versions

/

Lista todas as versões dos objetos.

-d, --dirs

/

Lista apenas os arquivos e subdiretórios de primeiro nível no diretório especificado, sem recursividade.

--encoding-type

string

Define o tipo de codificação para nomes de objetos ou arquivos. Valor válido: url.

--end-with

string

Lista somente os objetos cujos nomes são lexicograficamente menores ou iguais ao valor definido.

--exclude

stringArray

Exclui arquivos e caminhos correspondentes às regras especificadas.

--exclude-from

stringArray

Lê as regras de exclusão do arquivo de regras especificado.

--files-from

stringArray

Lê a lista de nomes de arquivos de source de um arquivo. Linhas vazias e linhas iniciadas com cerquilha (#) são ignoradas.

--files-from-raw

stringArray

Lê a lista de nomes de arquivos de source de um arquivo.

--filter

stringArray

Define uma ou mais regras de filtro para caminhos ou nomes de arquivos.

--filter-from

stringArray

Lê as regras de filtro do arquivo de regras especificado.

-f, --force

/

Força a operação e suprime prompts de confirmação.

--include

stringArray

Inclui somente arquivos e caminhos correspondentes às regras especificadas.

--include-from

stringArray

Lê as regras de inclusão do arquivo de regras especificado.

--limited-num

int

Define o número máximo de resultados a retornar.

--list-objects

/

Lista objetos usando a operação da API ListObjects (GetBucket).

--max-size

SizeSuffix

Lista somente objetos com tamanho igual ou inferior ao especificado. A unidade padrão é bytes. É possível usar sufixos como B, K, M, G, T ou P. Observe que 1 K equivale a um kibibyte (1.024 bytes).

--metadata-exclude

stringArray

Define regras de exclusão para metadados do objeto.

--metadata-filter

stringArray

Define regras de filtro para metadados do objeto.

--metadata-filter-from

stringArray

Lê as regras de filtro de metadados do arquivo de regras especificado.

--metadata-include

stringArray

Define regras de inclusão para metadados do objeto.

--min-age

Duration

Lista somente arquivos mais antigos que a duração especificada. A unidade padrão é segundos. Também é possível usar sufixos de unidade, como h para horas.

Nota

Por exemplo, --min-age 1h lista apenas arquivos modificados pela última vez há mais de uma hora.

--max-age

Duration

Lista somente arquivos modificados dentro da duração especificada. A unidade padrão é segundos. Também é possível usar sufixos de unidade, como h para horas.

Nota

Por exemplo, --max-age 1h lista apenas arquivos modificados na última hora.

--min-mtime

Time

Lista somente arquivos modificados após o horário especificado. O horário deve estar no formato UTC, como 2006-01-02T15:04:05Z.

Nota

Por exemplo, --min-mtime "2006-01-02T15:04:05Z" lista apenas arquivos modificados pela última vez após as 15:04:05 de 2 de janeiro de 2006.

--max-mtime

Time

Lista somente arquivos modificados antes do horário especificado. O horário deve estar no formato UTC, como 2006-01-02T15:04:05Z.

--min-size

SizeSuffix

Lista somente objetos com tamanho igual ou superior ao especificado. A unidade padrão é bytes. É possível usar sufixos como B, K, M, G, T ou P. Observe que 1 K (KiB) equivale a 1.024 bytes.

--multipart

/

Lista tarefas de upload multipart incompletas.

--page-size

int

Define o número máximo de objetos a retornar por página em uma operação em lote. O valor padrão é 1.000. Os valores válidos variam de 1 a 1.000.

-r, --recursive

/

Lista recursivamente todos os objetos correspondentes. Sem essa opção, o comando lista apenas itens de primeiro nível no caminho especificado.

--request-payer

string

Especifica o pagador da solicitação. Se o bucket usar o modo Requester Pays, defina esta opção como requester.

--short-format

/

Exibe a saída em formato curto. O formato longo é usado por padrão.

--start-after

string

Lista somente os objetos cujos nomes são lexicograficamente maiores que o valor especificado.

--resource-group-id

string

Especifica o ID do grupo de recursos.

Nota

Para mais informações, consulte Command-line options.

Exemplos

  • Liste todos os buckets.

    ossutil ls
  • Liste todos os objetos no bucket chamado examplebucket.

    ossutil ls oss://examplebucket
  • Liste todos os objetos com o prefixo dir/ no bucket chamado examplebucket.

    ossutil ls oss://examplebucket/dir
  • Liste apenas os objetos e subdiretórios de primeiro nível no diretório dir/ do bucket chamado examplebucket.

    ossutil ls oss://examplebucket/dir -d
  • Liste os primeiros 100 objetos com o prefixo dir/ no bucket chamado examplebucket.

    ossutil ls oss://examplebucket/dir --limited-num 100
  • Liste todos os arquivos .txt nos diretórios dir1/ e dir2/ (incluindo subdiretórios) no bucket chamado examplebucket.

    ossutil ls oss://examplebucket/ --include "/dir1/**.txt" --include "/dir2/**.txt"
  • Liste todos os arquivos criados nos últimos três dias nos diretórios dir1/ e dir2/ (incluindo subdiretórios) no bucket chamado examplebucket.

    ossutil ls oss://examplebucket --include "/dir1/**" --include "/dir2/**" --max-age 3d
  • Liste todos os buckets e formate a saída em JSON.

    ossutil ls --output-format json