Lista todos os objetos no bucket especificado do Object Storage Service (OSS).
Observações de uso
Por padrão, uma conta Alibaba Cloud tem permissão para listar todos os objetos em um bucket. Para listar objetos com um usuário RAM ou o Security Token Service (STS), você precisa da permissão
oss:ListObjects. Para mais informações, consulte Conceder uma política personalizada.O comando list-objects (get-bucket) foi atualizado para uma versão mais recente: list-objects-v2 (get-bucket-v2). Recomendamos usar o list-objects-v2 (get-bucket-v2) no desenvolvimento de aplicações. O OSS mantém o suporte ao comando list-objects (get-bucket) para garantir compatibilidade com versões anteriores.
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 |
Nome do bucket. |
|
--delimiter |
string |
Caractere usado para agrupar objetos por nome. |
|
--encoding-type |
string |
Tipo de codificação dos nomes de objeto na resposta. |
|
--marker |
string |
Nome do objeto a partir do qual a operação list-objects começa. Se especificado, a operação retorna apenas objetos cujos nomes venham depois do valor de marker em ordem alfabética. |
|
--max-keys |
int |
Número máximo de objetos a retornar. |
|
--prefix |
string |
Prefixo obrigatório nos nomes dos objetos retornados. |
O comando list-objects equivale à operação GetBucket (ListObjects). Para mais detalhes sobre essa operação da API, consulte GetBucket (ListObjects).
Para obter mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções de linha de comando.
Exemplos
Liste todos os objetos em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucketListe todos os objetos no bucket examplebucket e formate a saída em JSON.
ossutil api list-objects --bucket examplebucket --output-format jsonListe todos os objetos no bucket examplebucket e formate a saída em YAML.
ossutil api list-objects --bucket examplebucket --output-format yamlListe todos os objetos com o prefixo dir no nome em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucket --prefix dirListe os primeiros 100 objetos com o prefixo dir no nome em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucket --prefix dir --max-keys 100Liste todos os objetos no diretório atual em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucket --delimiter /Liste objetos cujos nomes venham após test.txt em ordem alfabética em um bucket chamado examplebucket.
ossutil api list-objects --bucket examplebucket --marker test.txtListe todos os objetos em um bucket chamado examplebucket e codifique os nomes dos objetos na resposta com URL.
ossutil api list-objects --bucket examplebucket --encoding-type url