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 Grant custom permissions to a RAM user.
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 seu sistema operacional. Para mais informações, consulte ossutil command reference.
Para obter detalhes sobre o status de restauração e o faturamento de objetos Archive, Cold Archive ou Deep Cold Archive, consulte Restore objects.
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 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. Se você não especificar esta opção, 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 usar esta opção: Especifique um arquivo local nos formatos .txt ou XML. Liste no arquivo todos os objetos a restaurar, 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 registra as informações de erro no arquivo de relatório e continua a restauração dos demais objetos. Informações sobre objetos restaurados com sucesso não são registradas no arquivo de relatório.
--snapshot-path	Gera snapshots apenas para os objetos da operação atual. Caso já existam snapshots para esses objetos, a operação é ignorada. Nota Esta opção deve ser usada 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 pelo número de dias definido no parâmetro Days da solicitação (padrão: 1 dia se nenhum config.xml for fornecido). O estado restaurado pode ser estendido 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 Copy an object and change its storage class.

Ao restaurar um objeto Archive, crie um arquivo XML local chamado config.xml para configurar a duração do estado restaurado.

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

Restaurar um único objeto Archive
- O exemplo abaixo 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
```
- Este exemplo demonstra a restauração de 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 saber como obter todas as versões de um objeto, consulte ls (List account-level resources).
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/ — siga os passos abaixo.
  1. Liste os nomes dos objetos Archive a 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 Example 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 exibe 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: A restauração ocorre entre 2 e 5 horas.
Bulk: A restauração ocorre entre 5 e 12 horas.

Nota

Diferentes prioridades de restauração implicam custos distintos para solicitações e capacidade de recuperação de dados, sendo a prioridade Expedited a mais onerosa. Para mais informações, consulte Request fees.

Restaurar um único objeto Cold Archive

O comando a seguir restaura o objeto exampleobject.jpg no bucket examplebucket em até 1 hora e o mantém 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/ — siga os passos abaixo.
  1. Liste os nomes dos objetos Cold Archive a restaurar 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. Conforme as configurações do arquivo config.xml, os objetos serã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 Example 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 exibe 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:

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: A restauração ocorre em até 48 horas.

Nota

Diferentes prioridades de restauração implicam custos distintos para solicitações e capacidade de recuperação de dados, sendo a prioridade Expedited a mais onerosa. Para mais informações, consulte Request fees.

Restaurar um único objeto Deep Cold Archive

Conforme as configurações do arquivo config.xml, o comando abaixo 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/ — siga os passos abaixo.
  1. Adicione os nomes dos objetos Deep Cold Archive a restaurar 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, mantendo-os 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 Example 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 da pasta dest no 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

Common options.

Referências

Para verificar se um objeto foi restaurado, consulte stat (View bucket and object information).
Para manter um objeto OSS permanentemente restaurado, consulte How do I keep an OSS object permanently restored?.