Todos os produtos
Search

Este produto

    Object Storage Service:list-objects-v2 (get-bucket-v2)

    Central de documentação

    Object Storage Service:list-objects-v2 (get-bucket-v2)

    Última atualização: Jul 03, 2026

    Lista todos os objetos em um bucket.

    Observações de uso

    • Por padrão, uma conta Alibaba Cloud tem permissão para listar todos os objetos em um bucket. Para listar todos os objetos em um bucket com um usuário RAM ou o Security Token Service (STS), é necessária a permissão oss:ListObjects. Para mais informações, consulte Conceder uma política personalizada.

    • A solicitação GetBucketV2 (ListObjectsV2) não retorna metadados do usuário.

    Sintaxe do comando

    ossutil api list-objects-v2 --bucket value [flags]

    Parâmetro

    Tipo

    Descrição

    --bucket

    string

    Nome do bucket.

    --continuation-token

    string

    Token que define o início da operação de listagem.

    --delimiter

    string

    Caractere usado para agrupar objetos por nome.

    --encoding-type

    string

    Tipo de codificação dos nomes dos objetos na resposta.

    --fetch-owner

    string

    Define se as informações do proprietário do objeto devem ser incluídas na resposta.

    --max-keys

    int

    Número máximo de objetos retornados.

    --prefix

    string

    Prefixo obrigatório nos nomes dos objetos retornados.

    --start-after

    string

    Posição inicial da operação de listagem. Retorna, em sequência, os objetos cujos nomes são alfabeticamente posteriores ao valor deste parâmetro.
    Nota

    • O comando list-objects-v2 (get-bucket-v2) corresponde à operação ListObjectsV2 (GetBucketV2). Para obter detalhes sobre os parâmetros da operação ListObjectsV2(GetBucketV2), consulte ListObjectsV2 (GetBucketV2).

    • Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções globais de linha de comando.

    Exemplos

    Execute o seguinte comando para listar todos os objects em um bucket chamado examplebucket:

    ossutil api list-objects-v2 --bucket examplebucket

    Para listar todos os objects em um bucket chamado examplebucket e exibir os resultados no formato JSON, execute:

    ossutil api list-objects-v2 --bucket examplebucket --output-format json

    Use este comando para listar todos os objects em um bucket chamado examplebucket e exibir os resultados no formato YAML:

    ossutil api list-objects-v2 --bucket examplebucket --output-format yaml

    Execute o comando abaixo para listar todos os objects cujos nomes contêm o prefixo dir em um bucket chamado examplebucket:

    ossutil api list-objects-v2 --bucket examplebucket --prefix dir

    Para listar os primeiros 100 objects cujos nomes contêm o prefixo dir em um bucket chamado examplebucket, execute:

    ossutil api list-objects-v2 --bucket examplebucket --prefix dir --max-keys 100

    Use o seguinte comando para listar os objects no diretório atual de um bucket chamado examplebucket:

    ossutil api list-objects-v2 --bucket examplebucket --delimiter /

    Execute este comando para listar os objects cujos nomes são alfabeticamente posteriores a test.txt em um bucket chamado examplebucket:

    ossutil api list-objects-v2 --bucket examplebucket --start-after test.txt

    Para listar todos os objects em um bucket chamado examplebucket e codificar os nomes dos objects em URL, execute:

    ossutil api list-objects-v2 --bucket examplebucket --encoding-type url

    Use o comando abaixo para listar todos os objects em um bucket chamado examplebucket e incluir as informações do proprietário nos resultados retornados:

    ossutil api list-objects-v2 --bucket examplebucket --fetch-owner

    Execute o seguinte comando para listar os objects após CgJiYw123 em um bucket chamado examplebucket:

    ossutil api list-objects-v2 --bucket examplebucket --continuation-token CgJiYw123