Todos os produtos
Search
Central de documentação

Object Storage Service:revert-versioning

Última atualização: Jul 03, 2026

O comando revert-versioning restaura um objeto excluído em um bucket com versionamento habilitado para sua versão mais recente.

Notas de uso

  • Para restaurar uma versão de um objeto, você precisa das permissões oss:ListObjectVersions e oss:DeleteObjectVersion. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.

  • Para o ossutil 1.6.16 e versões posteriores, você pode usar ossutil como nome do binário nos comandos. Não é necessário alterar o nome do binário para diferentes sistemas operacionais. Para versões do ossutil anteriores à 1.6.16, altere o nome do binário de acordo com o sistema operacional. Para mais informações, consulte Referência de comandos do ossutil.

Sintaxe do comando

ossutil revert-versioning oss://bucketname[/prefix]
[--encoding-type <value>]
[-r,--recursive]
[--start-time <value> ]
[--end-time <value>]
[--include <value>]
[--exclude <value>]
[--payer <value>]

A seguir estão descritos os parâmetros e opções:

Parâmetro/Opção

Descrição

bucketname

Nome do bucket.

prefix

Recursos em um bucket, como pastas e arquivos.

--encoding-type

Tipo de codificação do prefixo que segue oss://bucket_name. Valor válido: url. Se essa opção não for especificada, o prefixo não será codificado.

-r, --recursive

Se essa opção for especificada, o ossutil restaura todos os objetos correspondentes ao prefixo para suas versões mais recentes. Caso contrário, o ossutil restaura apenas o objeto especificado para sua versão mais recente.

--start-time

Início do intervalo de tempo. O valor é um timestamp UNIX. Se essa opção for especificada, os objetos excluídos antes desse horário serão ignorados.

--end-time

Fim do intervalo de tempo. O valor é um timestamp UNIX. Se essa opção for especificada, os objetos excluídos após esse horário serão ignorados.

--include

Inclui todos os objetos que atendem às condições especificadas.

Para mais informações, consulte Opções --include e --exclude.

--exclude

Exclui todos os objetos que atendem às condições especificadas.

Para mais informações, consulte Opções --include e --exclude.

--payer

Pagador da solicitação. Se você quiser que o solicitante que acessa os recursos no caminho especificado pague pelas taxas, como tráfego e solicitações, defina essa opção como requester.

Exemplos

  • Cenários de recuperação

    • Restaure o objeto excluído exampleobject.jpg no bucket examplebucket para sua versão mais recente.

      ossutil revert-versioning oss://examplebucket/exampleobject.jpg
    • Use a opção -r para restaurar vários objetos excluídos correspondentes ao prefixo destdir no bucket examplebucket para suas versões mais recentes.

      ossutil revert-versioning oss://examplebucket/destdir -r
    • Use a opção -r para restaurar todos os objetos excluídos no bucket examplebucket para suas versões mais recentes.

      ossutil revert-versioning oss://examplebucket  -r
    • Restaure objetos excluídos dentro de um intervalo de tempo especificado para suas versões mais recentes.

      Use a opção -r para restaurar objetos excluídos do bucket examplebucket entre 16:22:58 e 16:39:38 (UTC+8) em 16 de junho de 2020 para suas versões mais recentes.

      ossutil revert-versioning oss://examplebucket -r --start-time 1592295778 --end-time 1592296778
    • Restaure todos os objetos excluídos que correspondem a condições especificadas para suas versões mais recentes.

      • Use a opção -r para restaurar todos os objetos TXT excluídos no bucket examplebucket para suas versões mais recentes.

        ossutil revert-versioning oss://examplebucket --include "*.txt" -r
      • Use a opção -r para restaurar todos os objetos excluídos, exceto os objetos JPG, no bucket examplebucket para suas versões mais recentes.

        
        ossutil revert-versioning oss://examplebucket --exclude "*.jpg" -r
  • Saída de exemplo

    Se os objetos forem restaurados, a saída incluirá o número de objetos restaurados e o tempo decorrido. Veja a seguir uma saída de exemplo:

    revert versioning object count is 10, batch list count is 10
    
    0.066413(s) elapsed

Opções comuns

Para acessar um bucket em uma região diferente, use -e para especificar o endpoint. Para acessar um bucket pertencente a uma conta diferente da Alibaba Cloud, use -i para o AccessKey ID e -k para o AccessKey secret.

Por exemplo, para restaurar o objeto excluído exampletest.png no bucket testbucket para sua versão mais recente, execute o seguinte comando. O bucket está na região China (Shanghai) e pertence a outra conta da Alibaba Cloud.

ossutil revert-versioning oss://testbucket/exampletest.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Opções comuns.