Todos os produtos
Search
Central de documentação

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

Última atualização: Jul 03, 2026

Use o comando ls para listar informações sobre buckets, objetos e partes de upload multipart. Esse comando auxilia na consulta e no gerenciamento de recursos do Object Storage Service (OSS), permitindo 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 Conceder uma política personalizada.

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 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 apenas objetos cujos nomes sejam lexicograficamente menores ou iguais ao valor especificado.

--exclude

stringArray

Exclui arquivos e caminhos correspondentes às regras especificadas.

--exclude-from

stringArray

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

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

--filter-from

stringArray

Lê regras de filtro do arquivo de regras especificado.

-f, --force

/

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

--include

stringArray

Inclui apenas arquivos e caminhos correspondentes às regras especificadas.

--include-from

stringArray

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

--limited-num

int

Define o número máximo de resultados retornados.

--list-objects

/

Lista objetos por meio da operação de API ListObjects (GetBucket).

--max-size

SizeSuffix

Lista apenas objetos com tamanho menor ou igual ao especificado. A unidade padrão é bytes. Use sufixos como B, K, M, G, T ou P. Note que 1 K representa um kibibyte (1.024 bytes).

--metadata-exclude

stringArray

Especifica regras de exclusão para metadados de objetos.

--metadata-filter

stringArray

Especifica regras de filtro para metadados de objetos.

--metadata-filter-from

stringArray

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

--metadata-include

stringArray

Especifica regras de inclusão para metadados de objetos.

--min-age

Duration

Lista apenas 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 apenas 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 apenas 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 após as 15:04:05 de 2 de janeiro de 2006.

--max-mtime

Time

Lista apenas 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 apenas objetos com tamanho maior ou igual ao especificado. A unidade padrão é bytes. Use sufixos como B, K, M, G, T ou P. Note 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 retornados 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 utilizar 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 apenas objetos cujos nomes sejam lexicograficamente maiores que o valor especificado.

--resource-group-id

string

Especifica o ID do grupo de recursos.

Nota

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

Exemplos

  • Liste todos os buckets.

    ossutil ls
  • Liste todos os objetos no bucket examplebucket.

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

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

    ossutil ls oss://examplebucket/dir -d
  • Liste os primeiros 100 objetos com o prefixo dir/ no bucket 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 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 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