Restaurar um objeto arquivado

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.

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 '{}'

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 obter mais informações, consulte restore-object na Referência de comandos da AWS CLI.

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 RestoreObject na Referência da API do Amazon Simple Storage Service.

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 na Referência de API do Amazon 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 ter mais informações, consulte Especificar um manifesto.

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.

Para receber mais informações sobre operações em lote, consulte Restaurar objetos com operações em lote e Criar um trabalho de operações em lote do 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. Para obter mais informações sobre os vários tipos de evento ObjectRestore, consulte Tipos de evento compatíveis com SQS, SNS e Lambda.

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 head-object na Referência de comandos da AWS CLI.

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 HeadObject na Referência da API do Amazon Simple Storage Service.