Lista todos os objetos no bucket especificado do Object Storage Service (OSS).
Notas de uso
Por padrão, uma conta Alibaba Cloud possui permissões para listar todos os objetos em um bucket. Para listar todos os objetos em um bucket por meio de um usuário RAM ou do Security Token Service (STS), você precisa ter a permissão
oss:ListObjects. Para mais informações, consulte Grant a custom policy.O comando list-objects (get-bucket) foi atualizado para uma versão mais recente: list-objects-v2 (get-bucket-v2). Recomendamos utilizar list-objects-v2 (get-bucket-v2) no desenvolvimento de suas aplicações. Para manter a compatibilidade com versões anteriores, o OSS continua oferecendo suporte ao comando list-objects (get-bucket).
O comando list-objects (get-bucket) não retorna metadados de usuário dos objetos.
Sintaxe do comando
ossutil api list-objects --bucket value [flags]|
Parâmetro |
Tipo |
Descrição |
|
--bucket |
string |
O nome do bucket. |
|
--delimiter |
string |
O caractere usado para agrupar objetos por nome. |
|
--encoding-type |
string |
O tipo de codificação dos nomes dos objetos na resposta. |
|
--marker |
string |
O nome do objeto a partir do qual a operação list-objects inicia. Quando especificado, retorna os objetos cujos nomes estejam em ordem alfabética após o valor de marker. |
|
--max-keys |
int |
O número máximo de objetos a retornar. |
|
--prefix |
string |
O prefixo que os nomes dos objetos retornados devem conter. |
O comando list-objects é equivalente à operação GetBucket (ListObjects). Para mais informações sobre essa operação de API, consulte GetBucket (ListObjects).
Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Command-line options.
Exemplos
Liste todos os objetos em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucketListe todos os objetos em um bucket chamado examplebucket e formate a saída em JSON.
ossutil api list-objects --bucket examplebucket --output-format jsonListe todos os objetos em um bucket chamado examplebucket com a saída formatada em YAML.
ossutil api list-objects --bucket examplebucket --output-format yamlListe todos os objetos cujo nome contenha o prefixo dir em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucket --prefix dirListe os primeiros 100 objetos cujo nome contenha o prefixo dir em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucket --prefix dir --max-keys 100Liste todos os objetos no diretório atual de um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucket --delimiter /Liste os objetos cujos nomes estejam em ordem alfabética após test.txt em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucket --marker test.txtListe todos os objetos em um bucket chamado examplebucket e aplique codificação URL aos nomes dos objetos na resposta.
ossutil api list-objects --bucket examplebucket --encoding-type url