

# Trabalhando com objetos arquivados
<a name="archived-objects"></a>

Para reduzir os custos de armazenamento de objetos acessados com pouca frequência, você pode *arquivar* esses objetos. Quando você arquiva um objeto, ele é movido para um armazenamento de baixo custo, o que significa que não é possível acessá-lo em tempo real. 

Embora os objetos arquivados não estejam acessíveis em tempo real, você pode restaurá-los em minutos ou horas, dependendo da classe de armazenamento. Você pode restaurar um objeto arquivado usando o console do Amazon S3, o Operações em Lote do S3, a API REST, os AWS SDKs e a AWS Command Line Interface (AWS CLI). Para instruções, consulte [Restaurar um objeto arquivado](restoring-objects.md).

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

Para restaurar objetos arquivados, você deve fazer o seguinte:
+ Para objetos nas classes de armazenamento S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive, você deve iniciar a solicitação de restauração e aguardar até que uma cópia temporária do objeto esteja disponível. Se for criada uma cópia temporária do objeto restaurado, a classe de armazenamento do objeto permanecerá a mesma. (Uma solicitação de operação de API [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectHEAD.html) ou [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) retornará S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive como a classe de armazenamento.) 
+ Para objetos nos níveis Acesso de arquivamento e Acesso de arquivamento profundo do S3 Intelligent-Tiering, você deve iniciar a solicitação de restauração e esperar até que o objeto seja movido para o nível Acesso frequente. 

Para obter mais informações sobre como todas as classes de armazenamento do Amazon S3 se comparam, consulte [Compreender e gerenciar classes de armazenamento do Amazon S3](storage-class-intro.md). Para obter mais informações sobre o S3 Intelligent-Tiering, consulte [Como o S3 Intelligent-Tiering funciona](intelligent-tiering-overview.md).

O tempo necessário para concluir um trabalho de restauração depende da classe ou do nível de armazenamento de arquivo usado e da opção de recuperação especificada: expressa (disponível apenas para o S3 Glacier Flexible Retrieval e o S3 Intelligent-Tiering Archive Access), padrão ou em massa. Para obter mais informações, consulte [Noções básicas sobre as opções de recuperação de arquivos](restoring-objects-retrieval-options.md).

Você pode ser notificado quando sua restauração for concluída usando as Notificações de Eventos do Amazon S3. Para obter mais informações, consulte [Notificações de eventos do Amazon S3](EventNotifications.md).

## Restaurar objetos do Amazon Glacier
<a name="archived-objects-glacier"></a>

Quando você usa o S3 Glacier Flexible Retrieval ou o S3 Glacier Deep Archive, o Amazon S3 restaura uma cópia temporária do objeto somente pela duração especificada. Depois disso, ele exclui a cópia restaurada do objeto. Você pode modificar o período de validade de uma cópia restaurada reenviando uma solicitação de restauração. Nesse caso, o Amazon S3 atualiza o período de expiração relativo à hora atual. 

**nota**  
Ao restaurar um objeto arquivado do S3 Glacier Flexible Retrieval ou do S3 Glacier Deep Archive, você paga pelo objeto arquivado e pela cópia restaurada temporariamente. Para obter mais informações sobre preços, consulte [Preços do Amazon S3](https://aws.amazon.com/s3/pricing/).

O Amazon S3 calcula o tempo de validade da cópia do objeto restaurado adicionando o número de dias especificado na solicitação de restauração à hora de conclusão da restauração solicitada. Depois, o Amazon S3 arredonda a hora resultante para o próximo dia à meia-noite do Tempo Universal Coordenado (UTC). Por exemplo, suponha que a cópia de um objeto restaurado tenha sido criada em 15 de outubro de 2012, às 10h30 UTC, e o período de restauração tenha sido especificado como três dias. Nesse caso, a cópia restaurada expira em 19 de outubro de 2012, à 0h UTC, hora em que o Amazon S3 vai excluir a cópia do objeto. 

## Restaurar objetos do S3 Intelligent-Tiering
<a name="archived-objects-int"></a>

Quando você está restaurando um objeto dos níveis S3 Intelligent-Tiering Archive Access ou S3 Intelligent-Tiering Deep Archive Access, o objeto volta para o nível S3 Intelligent-Tiering Frequent Access. Se o objeto não for acessado depois de 30 dias consecutivos, ele será movido automaticamente para o nível Acesso infrequente. Depois de um período mínimo de 90 dias consecutivos sem acesso, o objeto é movido para o nível Acesso ao arquivamento do S3 Intelligent-Tiering. Se o objeto não for acessado depois de um período mínimo de 180 dias consecutivos, ele será movido para o nível Acesso profundo ao arquivamento.

**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`. 

## Usar o recurso Operações em Lote do S3 com solicitações de restauração
<a name="using-batch-ops-with-restore-requests"></a>

Para restaurar mais de um objeto do Amazon S3 com uma única solicitação, é possível usar 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. 

**Topics**
+ [Restaurar objetos do Amazon Glacier](#archived-objects-glacier)
+ [Restaurar objetos do S3 Intelligent-Tiering](#archived-objects-int)
+ [Usar o recurso Operações em Lote do S3 com solicitações de restauração](#using-batch-ops-with-restore-requests)
+ [Noções básicas sobre as opções de recuperação de arquivos](restoring-objects-retrieval-options.md)
+ [Restaurar um objeto arquivado](restoring-objects.md)

# Noções básicas sobre as opções de recuperação de arquivos
<a name="restoring-objects-retrieval-options"></a>

O Amazon S3 tem três classes de armazenamento para arquivamento: S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Enquanto os objetos armazenados na classe de armazenamento S3 Glacier Instant Retrieval são disponibilizados imediatamente usando `GET`, para acessar os dados armazenados na classe de armazenamento S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, primeiro é necessário recuperar os dados usando a API REST [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html). A restauração de conjuntos de dados compostos de dezenas de milhões de objetos ou centenas de terabytes de dados pode levar um tempo maior do que o tempo de restauração normal e exigir considerações especiais. Para obter mais informações, consulte [Restaurar grandes conjuntos de dados](#restoring-objects-large-datasets).

É possível escolher entre três opções de acesso de recuperação para restaurar objetos arquivados com base na velocidade de recuperação desejada: expressa, padrão e em massa.
+ **Expressa**: acesse rapidamente os dados armazenados na classe de armazenamento S3 Glacier Flexible Retrieval ou no nível S3 Intelligent-Tiering Archive Access. É possível usar essa opção em solicitações urgentes ocasionais para até centenas de objetos. Objetos com menos de 250 megabytes geralmente são disponibilizados em 1 a 5 minutos e objetos de 250 megabytes ou mais geralmente são recuperados com até 300 megabytes por segundo de throughput de recuperação. Além disso, existe a opção de comprar capacidade provisionada para recuperações expressas. A capacidade provisionada ajuda a garantir que a capacidade de recuperação expressa esteja disponível quando você precisar dela. Para obter mais informações, consulte [Capacidade provisionada](#restoring-objects-expedited-capacity).
**nota**  
As recuperações expressas são um recurso premium e são cobradas de acordo com a taxa de solicitação e recuperação expressas. Para receber informações sobre a definição de preços do Amazon S3, consulte [Definição de preços do Amazon S3](https://aws.amazon.com/s3/pricing/).
+ **Recuperação padrão**: acesse os dados em algumas horas. Padrão é a opção assumida para solicitações que não especificam a opção de recuperação. As recuperações padrão geralmente terminam em até 3 a 5 horas para a classe de armazenamento S3 Glacier Flexible Retrieval ou o nível Archive Access do S3 Intelligent-Tiering. Normalmente, as recuperações padrão terminam em até 12 horas para a classe de armazenamento S3 Glacier Deep Archive ou o nível S3 Intelligent-Tiering Deep Archive Access. As recuperações padrão são gratuitas para objetos armazenados na classe de armazenamento S3 Intelligent-Tiering.
**nota**  
Para objetos armazenados na classe de armazenamento S3 Glacier Flexible Retrieval ou no nível S3 Intelligent-Tiering Archive Access, as recuperações padrão iniciadas por meio da operação de restauração de Operações em Lote do S3 normalmente se iniciam em minutos e terminam em três a cinco horas, com throughput de até 1 a 2 petabytes por dia.
Para objetos na classe de armazenamento S3 Glacier Deep Archive ou no nível S3 Intelligent-Tiering Deep Archive Access, as recuperações padrão iniciadas por meio da funcionalidade Operações em Lote normalmente se iniciam em nove horas com um throughput de até 1 a 2 petabytes por dia.
+ **Recuperação em massa**: acesse os dados usando a opção de recuperação de menor custo nas classes de armazenamento S3 Glacier. Com as recuperações em massa, você pode recuperar grandes quantidades de dados por um baixo custo. Para objetos armazenados na classe de armazenamento S3 Glacier Flexible Retrieval ou no nível S3 Intelligent-Tiering Archive Access, as recuperações em massa normalmente terminam em cinco a doze horas. Para objetos armazenados na classe de armazenamento S3 Glacier Deep Archive ou no nível S3 Intelligent-Tiering Deep Archive Access, essas recuperações normalmente terminam em 48 horas. As recuperações em massa são gratuitas para objetos armazenados na classe de armazenamento S3 Glacier Flexible Retrieval ou S3 Intelligent-Tiering.

A tabela a seguir resume as opções de recuperação de arquivos. Para obter mais informações sobre preços, consulte [Preços do Amazon S3](https://aws.amazon.com/s3/pricing/).


| Classe ou nível de armazenamento | Expressa | Padrão (com o Operações em Lote) | Padrão (sem o Operações em Lote) | Em massa | 
| --- | --- | --- | --- | --- | 
|  Acesso ao arquivamento do S3 Glacier Flexible Retrieval ou do S3 Intelligent-Tiering  |  1 a 5 minutos  |  De minutos a 5 horas  |  3 a 5 horas  |  5 a 12 horas  | 
|  S3 Glacier Deep Archive ou S3 Intelligent-Tiering Deep Archive Acesso  |  Não disponível  |  De 9 a 12 horas  |  Em 12 horas  |  Em 48 horas  | 

Para fazer uma recuperação de `Expedited`, `Standard` ou `Bulk`, defina o elemento `Tier` da solicitação na solicitação da operação de API REST [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOSTrestore.html) que você deseja, ou o equivalente na AWS Command Line Interface (AWS CLI) ou em SDKs da AWS. Se você adquiriu a capacidade provisionada, todas as recuperações expressas serão automaticamente fornecidas por meio de sua capacidade provisionada. 

## Restaurar grandes conjuntos de dados
<a name="restoring-objects-large-datasets"></a>

A restauração de conjuntos de dados compostos de dezenas de milhões de objetos ou centenas de terabytes de dados pode levar um tempo maior do que o tempo de restauração normal em qualquer nível de recuperação devido aos limites de recuperação.

Quando você inicia solicitações de restauração de objetos que estão armazenados nas classes de armazenamento S3 Glacier Flexible Retrieval, S3 Glacier Deep Archive ou S3 Intelligent-Tiering, uma cota de solicitações de recuperação é aplicada para sua Conta da AWS. O S3 Glacier comporta solicitações de restauração em uma taxa de até 1.000 transações por segundo. Se essa taxa for excedida, as solicitações consideradas válidas em outros aspectos terão a utilização controlada ou serão rejeitadas, e o Amazon S3 retornará um erro `ThrottlingException`. É possível usar a funcionalidade Operações em Lote do S3 para recuperar vários objetos com uma única solicitação, a qual utiliza totalmente a taxa de solicitação de restauração disponível em sua conta. Para obter mais informações, consulte [Executar operações de objetos em massa com o Operações em Lote](batch-ops.md).

Ao iniciar solicitações de restauração, o S3 Glacier permite restaurar grandes conjuntos de dados com um throughput de até 1 a 2 petabytes por dia por conta de cliente. Seja qual for a opção de recuperação escolhida, os objetos com mais de 5 terabytes levarão mais tempo para serem restaurados, com um throughput de recuperação de até 300 megabytes por segundo. Por exemplo, um objeto do S3 Glacier Flexible Retrieval de 50 terabytes pode levar até 48 horas para ser recuperado. Se você precisar aumentar os limites de restauração, entre em contato com o AWS Support.

## Capacidade provisionada
<a name="restoring-objects-expedited-capacity"></a>

A capacidade provisionada ajuda a garantir que a capacidade de recuperação para recuperações aceleradas do S3 Glacier Flexible Retrieval esteja disponível quando você precisar. Cada unidade de capacidade garante que pelo menos três recuperações expressas possam ser realizadas a cada 5 minutos e oferece até 300 megabytes por segundo de throughput de recuperação.

Sem capacidade provisionada, as recuperações expressas podem não ser aceitas durante períodos de alta demanda. Para um acesso rápido e previsível a mais dados, considere a possibilidade de usar a classe de armazenamento [S3 Glacier Instant Retrieval](https://aws.amazon.com/s3/storage-classes/glacier/instant-retrieval/).

As unidades de capacidade provisionada são alocadas a uma Conta da AWS. Portanto, o solicitante da recuperação rápida de dados deve comprar a unidade de capacidade provisionada, não o proprietário do bucket.

É possível comprar capacidade provisionada usando o console do Amazon S3, o console do Amazon Glacier, a operação [Purchase Provisioned Capacity](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-PurchaseProvisionedCapacity.html) da API REST, os SDKs da AWS ou a AWS CLI. Para obter informações sobre a definição de preços da capacidade provisionada, consulte [Definição de preço do Amazon S3](https://aws.amazon.com/s3/pricing/).

# Restaurar um objeto arquivado
<a name="restoring-objects"></a>

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
<a name="restore-archived-objects"></a>

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
<a name="restoring-objects-console"></a>

**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
<a name="restoring-objects-cli"></a>

**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
<a name="restoring-objects-rest"></a>

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
<a name="restoring-objects-sdks"></a>

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
<a name="restoring-int-tier-archive-objects-batch-ops"></a>

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
<a name="restore-archived-objects-status"></a>

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
<a name="restore-archived-objects-status-console"></a>

**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
<a name="restore-archived-objects-status-event-notifications"></a>

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
<a name="restore-archived-objects-status-cli"></a>

**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
<a name="restore-archived-objects-status-api"></a>

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
<a name="restore-archived-objects-upgrade"></a>

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**. 