Lista as versões de todos os objetos em um bucket, incluindo os marcadores de exclua.
Notas de uso
Para listar as versões de objetos, você precisa da permissão oss:ListObjectVersions. Para obter mais informações, consulte Attach a custom policy to a RAM user.
Sintaxe do comando
ossutil api list-object-versions --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 do conteúdo na resposta. |
|
--key-marker |
string |
Retorna os objetos cujos nomes vêm após o valor do parâmetro key-marker em ordem alfabética. Você pode especificar este parâmetro junto com version-id-marker. |
|
--max-keys |
int |
O número máximo de objetos a serem retornados. |
|
--prefix |
string |
O prefixo que os nomes dos objetos retornados devem conter. |
|
--version-id-marker |
string |
O ID da versão do objeto especificado por key-marker a partir do qual a operação de listagem começa. As versões são retornadas da mais recente para a mais antiga. |
Para obter mais informações, consulte Command-line options.
Exemplos
-
Liste as versões de todos os objetos em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket -
Formate a saída em json ao listar as versões de todos os objetos em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --output-format json -
Gere a saída em yaml ao listar as versões de todos os objetos em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --output-format yaml -
Liste as versões de todos os objetos com o prefixo de nome "dir" em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --prefix dir -
Exiba as versões dos 100 primeiros objetos com o prefixo de nome "dir" em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --prefix dir --max-keys 100 -
Obtenha as versões de todos os objetos no diretório atual em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --delimiter / -
Consulte as versões de todos os objetos cujos nomes vêm alfabeticamente após "test.txt" em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --key-marker test.txt -
Codifique os nomes dos objetos retornados em url ao listar as versões de todos os objetos em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --encoding-type url -
Liste as versões de todos os objetos que vêm após a versão "123" do objeto test.txt em um bucket chamado examplebucket.
ossutil api list-object-versions --bucket examplebucket --key-marker test.txt --version-id-marker 123