Use the restore command to restore Archive, Cold Archive, and Deep Cold Archive OSS objects - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações

Para restaurar um único objeto, você precisa da permissão oss:RestoreObject. Para restaurar vários objetos em uma pasta, são necessárias as permissões oss:RestoreObject e oss:ListObjects. Para mais informações, consulte Conceder permissões personalizadas a um usuário RAM.
A partir da versão 1.6.16 do ossutil, use ossutil como nome do binário na linha de comando, independentemente do sistema operacional. Se utilizar uma versão anterior à 1.6.16, altere o nome do binário conforme o sistema operacional. Para mais informações, consulte Referência de comandos do ossutil.
Para obter detalhes sobre o status de restauração e o faturamento de objetos Archive, Cold Archive ou Deep Cold Archive, consulte Restaurar objetos.
Este comando está disponível apenas no ossutil 1.7.11 e versões posteriores.

Sintaxe do comando

ossutil restore oss://bucketname[/prefix][local_xml_file]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]
[-r, --recursive]
[-f, --force] 
[--object-file, <value>]
[--snapshot-path, <value>]
[--disable-ignore-error]
[--retry-times <value>]
[-j，--job <value>]

A tabela a seguir descreve os parâmetros e as opções do comando.

Parâmetro	Descrição
bucketname	Nome do bucket.
prefix	Os recursos em um bucket podem incluir pastas e arquivos.
local_xml_file	Arquivo XML local que armazena os parâmetros de restauração para objetos Cold Archive.
--encoding-type	Método de codificação para o prefixo. Defina o valor como url. Caso essa opção não seja especificada, o prefixo não será codificado.
--payer	Pagador da solicitação. Para que o solicitante pague taxas como tráfego e solicitações, defina esta opção como requester.
--version-id	ID da versão do objeto. Esta opção aplica-se apenas a objetos em buckets com versionamento ativado ou suspenso.
-r, --recursive	Restaura todos os objetos correspondentes ao prefixo. Sem essa opção, o ossutil restaura apenas o objeto especificado.
-f, --force	Força a operação sem solicitar confirmação.
--object-file	Restaura múltiplos objetos Archive, Cold Archive ou Deep Cold Archive em lote. Para utilizar esta opção: Especifique um arquivo local nos formatos .txt ou XML. Liste no arquivo todos os objetos a serem restaurados, colocando cada objeto em uma nova linha. O ossutil lê todos os objetos do arquivo local e os restaura em lote. Nota Se ocorrer um erro durante a restauração de um objeto, o ossutil registrará as informações de erro no arquivo de relatório e continuará a restaurar os demais objetos. Informações sobre objetos restaurados com sucesso não constam no arquivo de relatório.
--snapshot-path	Gera snapshots apenas para os objetos da operação atual. Se já existirem snapshots para os objetos, essa operação será ignorada. Nota Use esta opção em conjunto com a opção -r, --recursive ou --object-file.
--disable-ignore-error	Não ignora erros durante operações em lote.
--retry-times	Número de tentativas em caso de erro. Valor padrão: 10. Intervalo de valores: 1 a 500.
-j, --job	Número de tarefas simultâneas para operações em múltiplos objetos. Valor padrão: 3. Intervalo de valores: 1 a 10000.

Restaurar objetos Archive

A restauração de um objeto Archive leva cerca de um minuto. Não é possível ler o objeto enquanto ele está sendo restaurado.

Por padrão, um objeto restaurado permanece nesse estado por um dia. Se você executar o comando restore em um objeto já restaurado, o estado de restauração será estendido por mais um dia. Esse estado pode ser prorrogado por no máximo sete dias. Após esse período, o objeto retorna ao estado congelado.

Nota

Use o comando cp para alterar a classe de armazenamento de um objeto. Para mais informações, consulte Copiar um objeto e alterar sua classe de armazenamento.

Ao restaurar um objeto Archive, crie um arquivo XML local chamado config.xml para configurar o número de dias do estado restaurado.

<RestoreRequest>
    <Days>3</Days>
</RestoreRequest>

Restaurar um único objeto Archive
- O exemplo a seguir mostra como restaurar um objeto Archive chamado exampleobject.txt no bucket examplebucket e mantê-lo no estado restaurado por três dias.
```
ossutil restore oss://examplebucket/exampleobject.txt config.xml
```
- O exemplo abaixo demonstra como restaurar uma versão específica do objeto Archive chamado exampleobject.txt no bucket examplebucket.
```
ossutil restore oss://examplebucket/exampleobject.txt --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3**** config.xml
```
  Para mais informações sobre como obter todas as versões de um objeto, consulte ls (Listar recursos no nível da conta).
Restaurar múltiplos objetos Archive
- Exemplo 1: Objetos em pastas diferentes
  Para restaurar vários objetos Archive localizados em pastas diferentes do bucket examplebucket, como exampleobject1.jpg na pasta raiz, exampleobject2.png na pasta dir1/ e exampleobject3.txt na pasta dir2/, execute as etapas a seguir.
  1. Insira os nomes dos objetos Archive que deseja restaurar no arquivo local localfile.txt.
    exampleobject1.jpg dir1/exampleobject2.png dir2/exampleobject3.txt
  2. No arquivo config.xml, configure o estado restaurado para durar três dias.
    <RestoreRequest> <Days>3</Days> </RestoreRequest>
  3. Restaure múltiplos objetos Archive.
    
    Utilize a opção --object-file para restaurar vários objetos Archive no bucket examplebucket.
    ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
- Exemplo 2: Objetos na mesma pasta
  - Método 1
    
    Consulte o Exemplo 1 para restaurar múltiplos objetos Archive na mesma pasta de um bucket.
  - Método 2
    Use a opção -r para restaurar todos os objetos Archive da pasta dest especificada no bucket examplebucket.
    ossutil restore oss://examplebucket/dest -r config.xml
Saída

Em caso de sucesso, a saída inclui o horário de início da solicitação de restauração. Exemplo:
```
0.106852(s) elapsed
```

Restaurar objetos Cold Archive

Importante

O tempo real de restauração varia conforme o tamanho do objeto.

Antes de restaurar um ou mais objetos Cold Archive, crie um arquivo XML local chamado config.xml e configure os seguintes parâmetros de restauração no arquivo.

<RestoreRequest>
    <Days>3</Days>
    <JobParameters>
        <Tier>Bulk</Tier>
    </JobParameters>
</RestoreRequest>

A tabela a seguir descreve os parâmetros.

Parâmetro

Descrição

Days

Número de dias em que o objeto Cold Archive restaurado permanece no estado restaurado. Unidade: dias.

Intervalo de valores: 1 a 365

Tier

Prioridade de restauração para o objeto Cold Archive.

Valores válidos:

Expedited (alta prioridade): O objeto é restaurado em até 1 hora.
Standard: O objeto é restaurado entre 2 e 5 horas.
Bulk: O objeto é restaurado entre 5 e 12 horas.

Restaurar um único objeto Cold Archive

O comando a seguir restaura o objeto exampleobject.jpg no bucket examplebucket em até 1 hora e mantém o objeto no estado restaurado por três dias, conforme as configurações do arquivo config.xml.
```
ossutil restore oss://examplebucket/exampleobject.jpg config.xml
```
Restaurar múltiplos objetos Cold Archive
- Exemplo 1: Objetos em pastas diferentes
  Para restaurar vários objetos Cold Archive localizados em pastas diferentes do bucket examplebucket, como exampleobject1.jpg na pasta raiz, exampleobject2.png na pasta dir1/ e exampleobject3.txt na pasta dir2/, execute as etapas a seguir.
  1. Insira os nomes dos objetos Cold Archive a serem restaurados no arquivo local localfile.txt.
    exampleobject1.jpg dir1/exampleobject2.png dir2/exampleobject3.txt
  2. Restaure múltiplos objetos.
    
    Utilize a opção --object-file para restaurar vários objetos Cold Archive no bucket examplebucket. Com base nas configurações do arquivo config.xml, os objetos são restaurados em até 1 hora e mantidos no estado restaurado por três dias.
    ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
- Exemplo 2: Objetos na mesma pasta
  - Método 1
    
    Consulte o Exemplo 1 para restaurar múltiplos objetos Cold Archive na mesma pasta de um bucket.
  - Método 2
    Use a opção -r para restaurar todos os objetos Cold Archive da pasta dest no bucket examplebucket.
    ossutil restore oss://examplebucket/dest -r config.xml
Saída

Em caso de sucesso, a saída inclui o tempo decorrido para iniciar a solicitação de restauração. Por exemplo:
```
0.106852(s) elapsed
```

Restaurar objetos Deep Cold Archive

Importante

O tempo real de restauração depende do tamanho do objeto.

Antes de restaurar um ou mais objetos Deep Cold Archive, crie um arquivo XML local chamado config.xml e configure os seguintes parâmetros de restauração no arquivo.

<RestoreRequest>
    <Days>3</Days>
    <JobParameters>
        <Tier>Standard</Tier>
    </JobParameters>
</RestoreRequest>

Os parâmetros de configuração são os seguintes:

Parâmetro

Descrição

Days

Número de dias em que o objeto Deep Cold Archive restaurado permanece no estado restaurado. Unidade: dias.

Intervalo de valores: 1 a 365

Tier

Prioridade de restauração para o objeto Deep Cold Archive.

Valores válidos:

Expedited (alta prioridade): O objeto é restaurado em até 12 horas.
Standard: O objeto é restaurado em até 48 horas.

Restaurar um único objeto Deep Cold Archive

Com base nas configurações do arquivo config.xml, o comando a seguir restaura o objeto exampleobject.jpg no bucket examplebucket em até 48 horas e o mantém no estado restaurado por três dias.
```
ossutil restore oss://examplebucket/exampleobject.jpg config.xml
```
Restaurar múltiplos objetos Deep Cold Archive
- Exemplo 1: Objetos em pastas diferentes
  Para restaurar vários objetos Deep Cold Archive localizados em pastas diferentes do bucket examplebucket, como exampleobject1.jpg na pasta raiz, exampleobject2.png na pasta dir1/ e exampleobject3.txt na pasta dir2/, execute as etapas a seguir.
  1. Adicione os nomes dos objetos Deep Cold Archive a serem restaurados ao arquivo local localfile.txt.
    exampleobject1.jpg dir1/exampleobject2.png dir2/exampleobject3.txt
  2. Restaure múltiplos objetos.
    
    Utilize a opção --object-file para restaurar vários objetos Deep Cold Archive no bucket examplebucket em até 48 horas e mantê-los no estado restaurado por três dias. Esta operação baseia-se nas configurações do arquivo config.xml.
    ossutil restore oss://examplebucket --object-file localfile.txt --snapshot-path dir/ config.xml
- Exemplo 2: Objetos na mesma pasta
  - Método 1
    
    Consulte o Exemplo 1 para restaurar múltiplos objetos Deep Cold Archive na mesma pasta de um bucket.
  - Método 2
    Use a opção -r para restaurar todos os objetos Deep Cold Archive na pasta dest do bucket examplebucket.
    ossutil restore oss://examplebucket/dest -r config.xml
Saída

Em caso de sucesso, a saída exibe o tempo decorrido para iniciar a solicitação de restauração. Por exemplo:
```
0.106852(s) elapsed
```

Opções comuns

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

Por exemplo, para restaurar o objeto exampletest.png no bucket testbucket, localizado na região China (Shanghai) e pertencente a outra conta Alibaba Cloud, execute o seguinte comando:

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

Opções comuns.

Referências

Para verificar se um objeto foi restaurado, consulte stat (Visualizar informações de bucket e objeto).
Para manter um objeto OSS permanentemente restaurado, consulte Como mantenho um objeto OSS permanentemente restaurado?.