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:ListBucketsListar objetos:
oss:ListObjectsListar versões de objetos:
oss:ListObjectVersionsListar partes:
oss:ListPartseoss: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: |
|
--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 |
|
--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 Nota
Por exemplo, |
|
--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 Nota
Por exemplo, |
|
--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, |
|
--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 |
|
--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. |
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 bucketexamplebucket.ossutil ls oss://examplebucket/dir -
Liste apenas objetos e subdiretórios de primeiro nível no diretório
dir/do bucketexamplebucket.ossutil ls oss://examplebucket/dir -d -
Liste os primeiros 100 objetos com o prefixo
dir/no bucketexamplebucket.ossutil ls oss://examplebucket/dir --limited-num 100 -
Liste todos os arquivos .txt nos diretórios
dir1/edir2/(incluindo subdiretórios) no bucketexamplebucket.ossutil ls oss://examplebucket/ --include "/dir1/**.txt" --include "/dir2/**.txt" -
Liste todos os arquivos criados nos últimos três dias nos diretórios
dir1/edir2/(incluindo subdiretórios) no bucketexamplebucket.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