# Restaurar objetos com operações em lote
<a name="batch-ops-initiate-restore-object"></a>

Você pode usar o Operações em Lote do Amazon S3 para executar operações em lote de grande escala em objetos do Amazon S3. A operação **Restaurar** inicia solicitações de restauração dos objetos arquivados do Amazon S3 listados no manifesto. Os objetos a seguir devem ser restaurados para que possam ser acessados em tempo real:
+ Objetos arquivados nas classes de armazenamento S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive
+ Objetos arquivados por meio da classe de armazenamento do S3 Intelligent-Tiering nos níveis Acesso de arquivamento ou Acesso de arquivamento profundo

O uso de uma operação **Restaurar** ([https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_S3InitiateRestoreObjectOperation.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_S3InitiateRestoreObjectOperation.html)) no trabalho do Operações em Lote do S3 resulta em uma solicitação `RestoreObject` para cada objeto especificado no manifesto.

**Importante**  
O trabalho **Restaurar** só *inicia* a solicitação para restaurar objetos. As Operações em lote do S3 relatam o trabalho como concluído para cada objeto depois que a solicitação é iniciada para aquele objeto. O Amazon S3 não atualiza o trabalho nem o notificará quando os objetos tiverem sido restaurados. No entanto, é possível usar notificações de eventos do S3 para receber notificações quando os objetos estiverem disponíveis no Amazon S3. Para ter mais informações, consulte [Notificações de eventos do Amazon S3](EventNotifications.md).

Ao criar um trabalho de **Restaurar** os seguintes argumentos estão disponíveis:

**ExpirationInDays**  
Esse argumento especifica por quanto tempo o objeto do S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive permanecerá disponível no Amazon S3. Os trabalhos de **Restaurar** voltados para objetos do S3 Glacier Flexible Retrieval e do S3 Glacier Deep Archive exigem que você defina `ExpirationInDays` como `1` ou superior.  
Não defina `ExpirationInDays` ao criar trabalhos de operação de **Restaurar** voltados a objetos dos níveis S3 Intelligent-Tiering Archive Access e Deep Archive Access. Os objetos nos níveis de acesso de arquivo S3 Intelligent-Tiering não estão sujeitos a uma data de validade da restauração; portanto, especificar `ExpirationInDays` provoca uma falha na solicitação `RestoreObject`.

**GlacierJobTier**  
O Amazon S3 pode restaurar objetos usando um destes três diferentes níveis de recuperação: `EXPEDITED`, `STANDARD` e `BULK`. No entanto, o recurso Operações em lote do S3 suporta apenas os níveis de recuperação `STANDARD` e `BULK`. Para receber mais informações sobre as diferenças entre os níveis de recuperação, consulte [Noções básicas sobre as opções de recuperação de arquivos](restoring-objects-retrieval-options.md).   
Para receber mais informações sobre preço para cada nível, consulte a seção **Solicitações e recuperações de dados** na página [Definição de preço do Amazon S3](https://aws.amazon.com/s3/pricing/).

## Diferenças na restauração por meio do S3 Glacier e do S3 Intelligent-Tiering
<a name="batch-ops-initiate-restore-diff"></a>

A restauração de arquivos arquivados das classes de armazenamento S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive difere da restauração de arquivos da classe de armazenamento S3 Intelligent-Tiering nos níveis Acesso de arquivamento ou Acesso de arquivamento profundo.
+ Quando você restaura do S3 Glacier Flexible Retrieval ou S3 Glacier Deep Archive, uma *cópia* temporária do objeto é criada. O Amazon S3 exclui essa cópia após o término do valor especificado no argumento `ExpirationInDays`. Depois que essa cópia temporária for excluída, será preciso enviar uma solicitação de restauração adicional para acessar o objeto.
+ Ao restaurar objetos arquivados do S3 Intelligent-Tiering, *não* especifique o argumento `ExpirationInDays`. Quando você restaura um objeto do nível S3 Intelligent-Tiering Archive Access ou Deep Archive Access, o objeto faz a transição de volta ao nível S3 Intelligent-Tiering Frequent Access. Após no mínimo 90 dias consecutivos sem acesso, o objeto transita automaticamente para o nível Archive Access. Depois de um período mínimo de 180 dias consecutivos sem acesso, o objeto é movido automaticamente ao nível Deep Archive Access. 
+ 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. 

## Sobrepor restaurações
<a name="batch-ops-initiate-restore-object-in-progress"></a>

Se o trabalho [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_S3InitiateRestoreObjectOperation.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_S3InitiateRestoreObjectOperation.html) tentar restaurar um objeto que já esteja em processo de restauração, o Operações em Lote do S3 procederá da maneira indicada a seguir.

A operação de restauração será bem-sucedida para o objeto se uma das seguintes condições for verdadeira:
+ Quando comparado à solicitação de restauração já em andamento, o valor `ExpirationInDays` desse trabalho é o mesmo, e o valor `GlacierJobTier` é mais rápido.
+ A solicitação de restauração anterior já foi concluída, e o objeto está disponível no momento. Nesse caso, as operações em lote atualizam a data de validade do objeto restaurado para coincidir com o valor `ExpirationInDays` especificado na solicitação de restauração em andamento.

A operação apresenta falha para o objeto se uma das seguintes condições for verdadeira:
+ A solicitação de restauração já em andamento ainda não foi concluída, e a duração da restauração para esse trabalho (especificada pelo valor `ExpirationInDays`) é diferente da duração da restauração especificada na solicitação de restauração em andamento.
+ O nível de restauração para esse trabalho (especificado pelo valor `GlacierJobTier`) é o mesmo ou é mais lento do que o nível especificado na solicitação de restauração em andamento.

## Limitações
<a name="batch-ops-initiate-restore-object-limitations"></a>

Os trabalhos `S3InitiateRestoreObjectOperation` têm as seguintes limitações:
+ Você deve criar o trabalho na mesma região que os objetos arquivados.
+ O Operações em Lote do S3 não é compatível com o nível de recuperação `EXPEDITED`.
+ Um único trabalho de restauração de operações em lote pode comportar um manifesto com até 4 bilhões de objetos.

Para obter mais informações sobre a restauração de objetos, consulte [Restaurar um objeto arquivado](restoring-objects.md).