# Restaurar um objeto arquivado
Os objetos do Amazon S3 nas seguintes classes ou níveis de armazenamento são arquivados e não podem ser acessados em tempo real:
+ A classe de armazenamento S3 Glacier Flexible Retrieval
+ A classe de armazenamento S3 Glacier Deep Archive
+ O nível Acesso ao arquivamento do S3 Intelligent-Tiering
+ O nível de acesso de arquivamento profundo do S3 Intelligent-Tiering
Os objetos do Amazon S3 armazenados nas classes de armazenamento S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive não são acessíveis imediatamente. Para acessar um objeto nessas classes de armazenamento, você deve restaurar uma cópia temporária dele no bucket do S3 para uma duração especificada (número de dias). Se você quiser uma cópia permanente do objeto, restaure o objeto e crie uma cópia dele no bucket do Amazon S3. O console do Amazon S3 não comporta a cópia de objetos restaurados. Para esse tipo de operação de cópia, use a AWS Command Line Interface (AWS CLI), AWS SDKs ou a API REST. A menos que você faça uma cópia e altere a classe de armazenamento, o objeto ainda será armazenado nas classes de armazenamento S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive. Para receber informações sobre como usar essas classes de armazenamento, consulte [Classes de armazenamento para objetos acessados raramente](storage-class-intro.md#sc-glacier).
Para acessar objetos nos níveis S3 Intelligent-Tiering Archive Access e Deep Archive Access, você deve iniciar a solicitação de restauração e esperar até que o objeto seja movido para o nível Frequent Access para acessá-lo. Quando você restaura dos níveis Acesso de arquivamento ou Acesso de arquivamento profundo, o objeto faz a transição de volta para o nível Acesso frequente. Para receber informações sobre como usar essas classes de armazenamento, consulte [Classe de armazenamento para otimizar automaticamente dados com padrões de acesso alterados ou desconhecidos](storage-class-intro.md#sc-dynamic-data-access).
Para receber informações gerais sobre objetos arquivados, consulte [Trabalhando com objetos arquivados](archived-objects.md).
**nota**
Ao restaurar um objeto arquivado das classes de armazenamento S3 Glacier Flexible Retrieval ou do S3 Glacier Deep Archive, você paga pelo objeto arquivado e pela cópia restaurada temporariamente.
Quando você restaura um objeto do S3 Intelligent-Tiering, não há cobranças para recuperações padrão ou em massa.
As solicitações de restauração subsequentes chamadas em objetos arquivados que já estão sendo restaurados são cobradas como uma solicitação `GET`. Para obter mais informações sobre preços, consulte [Preços do Amazon S3](https://aws.amazon.com/s3/pricing/).
## Restaurar um objeto arquivado
Você pode restaurar um objeto arquivado usando o console do Amazon S3, a API REST do Amazon S3, os AWS SDKs, a AWS Command Line Interface (AWS CLI) ou o Operações em Lote do S3.
### Usar o console do S3
**Restaurar objetos usando o console do Amazon S3**
Use o procedimento a seguir para restaurar um objeto que foi arquivado na classe de armazenamento S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive ou no nível de armazenamento S3 Intelligent-Tiering Archive Access ou Deep Archive Access.
**Para restaurar um objeto arquivado**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Buckets de uso geral**.
1. Na lista de buckets, escolha o nome do bucket que contém os objetos que você deseja restaurar.
1. Na lista **Objects (Objetos)**, selecione o objeto ou os objetos que você deseja restaurar, selecione **Actions (Ações)** e escolha **Initiate restore (Iniciar restauração)**.
1. Se você estiver restaurando do S3 Glacier Flexible Retrieval ou do S3 Glacier Deep Archive, insira o número de dias em que deseja que seus dados arquivados fiquem acessíveis na caixa **Número de dias em que a cópia restaurada fica disponível**.
1. Em **Nível de recuperação**, siga um destes procedimentos:
+ Selecione **Recuperação em massa** ou **Recuperação padrão** e, depois, escolha **Iniciar restauração**.
+ Escolha **Expedited retrieval** (Recuperação acelerada) (disponível somente para o S3 Glacier Flexible Retrieval ou S3 Intelligent-Tiering Archive Access). Se você estiver restaurando um objeto no S3 Glacier Flexible Retrieval, poderá escolher se deseja comprar capacidade provisionada para recuperação expressa. Se quiser comprar capacidade provisionada, vá para a próxima etapa. Caso contrário, selecione **Iniciar restauração**.
**nota**
Os objetos dos níveis S3 Intelligent-Tiering Archive Access e Deep Archive Access são restaurados automaticamente para o nível Frequent Access.
1. (Opcional) Se você estiver restaurando um objeto no S3 Glacier Flexible Retrieval e escolher **Recuperação expressa**, poderá escolher se deseja comprar capacidade provisionada. A capacidade provisionada só está disponível para objetos no S3 Glacier Flexible Retrieval. Se você tiver a capacidade provisionada, escolha **Iniciar restauração** para iniciar uma recuperação provisionada.
Se você tiver a capacidade provisionada, todas as recuperações expressas serão atendidas pela capacidade provisionada. Para obter mais informações, consulte [Capacidade provisionada](restoring-objects-retrieval-options.md#restoring-objects-expedited-capacity).
+ Se você não tiver a capacidade provisionada e não desejar comprá-la, selecione **Iniciar restauração**.
+ Se você não tiver capacidade provisionada mas quiser comprar unidades de capacidade provisionada (PCUs), selecione **Comprar PCUs**. Na caixa de diálogo **Comprar PCUs**, escolha quantas PCUs você deseja comprar, confirme a compra e selecione **Comprar PCUs**. Ao receber a mensagem **Compra realizada**, selecione **Iniciar restauração** para iniciar a recuperação provisionada.
### Como usar o AWS CLI
**Restaurar objetos do S3 Glacier Flexible Retrieval ou do S3 Glacier Deep Archive**
O exemplo a seguir usa o comando `restore-object` para restaurar o objeto *`dir1/example.obj`* no bucket `amzn-s3-demo-bucket` por 25 dias.
```
aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Standard"}}'
```
Se a sintaxe JSON usada no exemplo resultar em um erro em um cliente Windows, substitua a solicitação de restauração pela seguinte sintaxe:
```
--restore-request Days=25,GlacierJobParameters={"Tier"="Standard"}
```
**Restaurar objetos do S3 Intelligent-Tiering Archive Access e Deep Archive Access**
O exemplo a seguir usa o comando `restore-object` para restaurar o objeto *`dir1/example.obj`* no bucket `amzn-s3-demo-bucket` no nível Frequent Access.
```
aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{}'
```
**nota**
Ao contrário das classes de armazenamento S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive, as solicitações de restauração para objetos S3 Intelligent-Tiering não aceitam o valor `Days`.
**Monitorar o status da restauração**
Para monitorar o status da solicitação `restore-object`, use o seguinte comando `head-object`:
```
aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj
```
Para ter mais informações, consulte [https://docs.aws.amazon.com//cli/latest/reference/s3api/restore-object.html](https://docs.aws.amazon.com//cli/latest/reference/s3api/restore-object.html) na *Referência de comandos da AWS CLI*.
### Uso da API REST
O Amazon S3 fornece uma operação de API para que você inicie a restauração de um objeto arquivado. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html) na *Referência da API do Amazon Simple Storage Service*.
### Usar SDKs da AWS
Consulte exemplos de como restaurar objetos arquivados no S3 Glacier Flexible Retrieval ou no S3 Glacier Deep Archive com os SDKs da AWS em [Exemplos de código](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_RestoreObject_section.html) na *Referência de API do Amazon S3*.
### Usar o Operações em Lote do S3
Para restaurar mais de um objeto arquivado com uma única solicitação, você pode usar o Operações em Lote do S3. Você fornece às operações em lote do S3 uma lista de objetos nos quais operar. O S3 Batch Operations chama a respectiva operação de API para executar a operação especificada. Um único trabalho de operações em lote pode realizar a operação especificada em bilhões de objetos contendo exabytes de dados.
Para criar um trabalho de operações em lote, você deve ter um manifesto que contenha somente os objetos a serem restaurados. Você pode criar um manifesto usando o Inventário S3 ou fornecer um arquivo CSV com as informações necessárias. Para obter mais informações, consulte [Especificar um manifesto](batch-ops-create-job.md#specify-batchjob-manifest).
Antes de criar e executar trabalhos de operações em lote no S3, você deve conceder permissões ao Amazon S3 para realizar essas operações em seu nome. Para ver as permissões necessárias, consulte [Conceder permissões para operações em lote](batch-ops-iam-role-policies.md).
**nota**
Os trabalhos de operações em lote podem operar em objetos das classes de armazenamento S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive *ou* em objetos dos níveis S3 Intelligent-Tiering Archive Access e Deep Archive Access. As operações em lote não podem operar nos dois tipos de objetos arquivados no mesmo trabalho. Para restaurar objetos de ambos os tipos, você *deve* criar trabalhos de Operações em lote separados.
Para receber mais informações sobre o uso de operações em lote para restauração de objetos de arquivo, consulte [Restaurar objetos com operações em lote](batch-ops-initiate-restore-object.md).
**Como criar um trabalho de operações em lote de iniciar restauração no S3**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação esquerdo, escolha **Batch Operations** (Operações em lote).
1. Escolha **Criar trabalho**.
1. Para **Região da AWS**, escolha a região onde você deseja criar o trabalho.
1. Em **Formato do manifesto**, selecione o tipo de manifesto a ser usado.
+ Se você escolher **Relatório de inventário do S3**, insira o caminho para o objeto `manifest.json` que o Amazon S3 gerou como parte do relatório de inventário em formato CSV. Se você quiser usar uma versão de manifesto que não seja a mais recente, insira o ID da versão do objeto `manifest.json`.
+ Se você selecionar **CSV**, insira o caminho para o objeto do manifesto formatado em CSV. O objeto do manifesto deve seguir o formato descrito no console. Se você quiser usar outra versão que não seja a mais recente, poderá incluir o ID da versão do objeto de manifesto.
1. Escolha **Próximo**.
1. Na seção **Operação**, escolha **Restaurar**.
1. Na seção **Restaurar**, em **Restaurar origem**, selecione **Glacier Flexible Retrieval ou Glacier Deep Archive** ou **Nível Intelligent-Tiering Archive Access ou Deep Archive Access**.
Se você escolheu **Glacier Flexible Retrieval ou Glacier Deep Archive**, insira um número para **Número de dias em que a cópia restaurada fica disponível**.
Em **Nível de recuperação**, selecione o nível que você deseja usar.
1. Escolha **Próximo**.
1.
Na página **Configurar opções adicionais**, preencha as seguintes seções:
+ Na seção **Opções adicionais**, forneça uma descrição para o trabalho e especifique um número de prioridade para ele. Números maiores indicam uma prioridade mais alta. Para obter mais informações, consulte [Atribuir prioridade aos trabalhos](batch-ops-job-priority.md).
+ Na seção **Relatório de conclusão**, selecione se as operações em lote devem criar um relatório de conclusão. Para receber mais informações sobre relatórios de conclusão, consulte [Relatórios de conclusão](batch-ops-job-status.md#batch-ops-completion-report).
+ Na seção **Permissões**, você deve conceder permissões ao Amazon S3 para realizar operações em lote em seu nome. Para ver as permissões necessárias, consulte [Conceder permissões para operações em lote](batch-ops-iam-role-policies.md).
+ (Opcional) Na seção **Tags de trabalho**, adicione tags em pares de chave-valor. Para obter mais informações, consulte [Controlar o acesso e rotular trabalhos usando tags](batch-ops-job-tags.md).
Quando terminar, escolha **Próximo**.
1. Na página **Review (Examinar)**, verifique as configurações. Se precisar fazer alterações, escolha **Previous (Anterior)**. Caso contrário, selecione **Criar trabalho**.
Para receber mais informações sobre operações em lote, consulte [Restaurar objetos com operações em lote](batch-ops-initiate-restore-object.md) e [Criar um trabalho de operações em lote do S3](batch-ops-create-job.md).
## Verificar o status de restauração e a data de expiração
Você pode verificar o status de uma solicitação de restauração ou a data de expiração usando o console do Amazon S3, as Notificações de eventos do Amazon S3, a AWS CLI ou a API REST do Amazon S3.
**nota**
Os objetos restaurados das classes de armazenamento S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive são armazenados apenas pelo número de dias que você especificar. Os procedimentos abaixo retornarão a data de expiração dessas cópias.
Os objetos restaurados dos níveis de armazenamento S3 Intelligent-Tiering Archive Access e Deep Archive Access não têm datas de expiração e, em vez disso, são movidos para o nível Frequent Access.
### Usar o console do S3
**Como conferir o status de restauração e a data de validade de um objeto no console do Amazon S3**
1. Abra o console do Amazon S3, em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Buckets de uso geral**.
1. Na lista de buckets, selecione o nome do bucket que contém os objetos que você está restaurando.
1. Na lista **Objetos**, selecione o objeto que você está restaurando. A página de detalhes do objeto é exibida.
+ Se a restauração não estiver concluída, você verá uma seção que indica **Restauração em andamento** na parte superior da página.
+ Se a restauração estiver concluída, você verá uma seção que indica **Restauração concluída** na parte superior da página. Se você estiver restaurando por meio do S3 Glacier Flexible Retrieval ou do S3 Glacier Deep Archive, essa seção também exibirá a **Data de expiração da restauração**. O Amazon S3 removerá a cópia restaurada do objeto arquivado nessa data.
### Usar Notificações de eventos do Amazon S3
Você pode receber notificações sobre a conclusão da restauração de um objeto usando a ação `s3:ObjectRestore:Completed` com o recurso Notificações de eventos do Amazon S3. Para obter mais informações sobre como habilitar notificações de eventos, consulte [Usar o Amazon SQS, o Amazon SNS e o AWS Lambda](how-to-enable-disable-notification-intro.md). Para obter mais informações sobre os vários tipos de evento `ObjectRestore`, consulte [Tipos de evento compatíveis com SQS, SNS e Lambda](notification-how-to-event-types-and-destinations.md#supported-notification-event-types).
### Como usar o AWS CLI
**Confira o status de restauração e a data de validade de um objeto com a AWS CLI.**
O exemplo a seguir usa o comando `head-object` para visualizar metadados referentes ao objeto *`dir1/example.obj`* no bucket `amzn-s3-demo-bucket`. Quando você executa esse comando em um objeto que está sendo restaurado, o Amazon S3 retorna se a restauração está em andamento e (se aplicável) a data de validade.
```
aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj
```
Saída esperada (restauração em andamento):
```
{
"Restore": "ongoing-request=\"true\"",
"LastModified": "2020-06-16T21:55:22+00:00",
"ContentLength": 405,
"ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
"VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
"ContentType": "binary/octet-stream",
"ServerSideEncryption": "AES256",
"Metadata": {},
"StorageClass": "GLACIER"
}
```
Saída esperada (restauração concluída):
```
{
"Restore": "ongoing-request=\"false\", expiry-date=\"Wed, 12 Aug 2020 00:00:00 GMT\"",
"LastModified": "2020-06-16T21:55:22+00:00",
"ContentLength": 405,
"ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
"VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
"ContentType": "binary/octet-stream",
"ServerSideEncryption": "AES256",
"Metadata": {},
"StorageClass": "GLACIER"
}
```
Para obter mais informações sobre `head-object`, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-object.html) na *Referência de comandos da AWS CLI*.
### Uso da API REST
O Amazon S3 fornece uma operação de API para você recuperar metadados do objeto. Para conferir o status da restauração e a data de validade de um objeto arquivado usando a API REST, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html) na *Referência da API do Amazon Simple Storage Service*.
## Atualizar a velocidade de uma restauração em andamento
Atualize a velocidade da restauração enquanto ela está em andamento.
**Para atualizar uma restauração em andamento para um nível mais rápido**
1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Buckets**.
1. Na lista **Buckets**, escolha o nome do bucket que contém os objetos que você deseja restaurar.
1. Na lista **Objetos**, selecione o objeto que você está restaurando. A página de detalhes do objeto é exibida. Na página de detalhes do objeto, selecione **Fazer upgrade do nível de recuperação**. Para obter informações sobre como verificar o status de restauração de um objeto, consulte [Verificar o status de restauração e a data de expiração](#restore-archived-objects-status).
1. Escolha o nível para o qual você deseja atualizar e selecione **Iniciar restauração**.