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