Todos os produtos
Search
Central de documentação

Object Storage Service:list-object-versions

Última atualização: Jul 03, 2026

Lista as versões de todos os objetos em um bucket, incluindo marcadores de exclusão.

Notas de uso

Para listar versões de objetos, você precisa da permissão oss:ListObjectVersions. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.

Sintaxe do comando

ossutil api list-object-versions --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 do conteúdo na resposta.

--key-marker

string

Retorna objetos cujos nomes aparecem após o valor do parâmetro key-marker em ordem alfabética. É possível especificar este parâmetro junto com version-id-marker.

--max-keys

int

Número máximo de objetos a retornar.

--prefix

string

Prefixo obrigatório nos nomes dos objetos retornados.

--version-id-marker

string

ID da versão do objeto especificado por key-marker a partir do qual a listagem começa. As versões são retornadas da mais recente para a mais antiga.

Nota

Para mais informações, consulte Opções de linha de comando.

Exemplos

  • Exclua as versões de todos os objetos no bucket examplebucket.

    ossutil api list-object-versions --bucket examplebucket
  • Exclua as versões de todos os objetos no bucket examplebucket e formate a saída em JSON.

    ossutil api list-object-versions --bucket examplebucket --output-format json
  • Exclua as versões de todos os objetos no bucket examplebucket e formate a saída em YAML.

    ossutil api list-object-versions --bucket examplebucket --output-format yaml
  • Exclua as versões de todos os objetos com o prefixo "dir" no bucket examplebucket.

    ossutil api list-object-versions --bucket examplebucket --prefix dir
  • Exclua as versões dos primeiros 100 objetos com o prefixo "dir" no bucket examplebucket.

    ossutil api list-object-versions --bucket examplebucket --prefix dir --max-keys 100
  • Exclua as versões de todos os objetos no diretório atual do bucket examplebucket.

    ossutil api list-object-versions --bucket examplebucket --delimiter /
  • Exclua as versões de todos os objetos cujos nomes aparecem após "test.txt" em ordem alfabética no bucket examplebucket.

    ossutil api list-object-versions --bucket examplebucket --key-marker test.txt
  • Exclua as versões de todos os objetos no bucket examplebucket e codifique os nomes dos objetos retornados em URL.

    ossutil api list-object-versions --bucket examplebucket --encoding-type url
  • Exclua as versões de todos os objetos posteriores à versão "123" do objeto test.txt no bucket examplebucket.

    ossutil api list-object-versions --bucket examplebucket --key-marker test.txt --version-id-marker 123