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:ListObjectVersionseoss: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.
-
Para mais informações sobre versionamento, consulte Versionamento.
-
Para mais informações sobre marcadores de exclusão, consulte Marcador de exclusão.
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 |
|
-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