Esta página é somente para clientes atuais do serviço Amazon Glacier que usam Vaults e a API REST original de 2012.

Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte as classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento Amazon S3 Glacier, que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurando notificações do Vault no Amazon Glacier

Recuperar qualquer coisa do Amazon Glacier, como um arquivo de um cofre ou um inventário de cofres, é um processo de duas etapas.

Você pode definir uma configuração de notificação em um cofre, de maneira que, quando um trabalho for concluído, uma mensagem será enviada para um tópico do Amazon Simple Notification Service (Amazon SNS).

Configurando notificações do Vault no Amazon Glacier: conceitos gerais

Uma solicitação de trabalho de recuperação do Amazon Glacier é executada de forma assíncrona. Você deve esperar até que o Amazon Glacier conclua o trabalho antes de obter sua saída. Você pode consultar periodicamente o Amazon Glacier para determinar o status do trabalho, mas essa não é uma abordagem ideal. O Amazon Glacier também oferece suporte a notificações. Quando um trabalho é concluído, ele pode publicar uma mensagem em um tópico do Amazon Simple Notification Service (Amazon SNS). Esse atributo exige que você defina a configuração de notificação no cofre. Na configuração, você identifica um ou mais eventos e um tópico do Amazon SNS para o qual deseja que o Amazon Glacier envie uma mensagem quando o evento ocorrer.

O Amazon Glacier define eventos especificamente relacionados à conclusão do trabalho (ArchiveRetrievalCompleted,InventoryRetrievalCompleted) que você pode adicionar à configuração de notificação do cofre. Quando um trabalho específico é concluído, o Amazon Glacier publica uma mensagem de notificação para o tópico do SNS.

A configuração de notificação é um documento JSON conforme mostrado no exemplo a seguir.

{    
   "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic",    
   "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] 
}

Você pode configurar somente um tópico do Amazon SNS para um cofre.

A mensagem de conclusão do trabalho que o Amazon Glacier envia inclui informações como o tipo de trabalho (InventoryRetrieval,ArchiveRetrieval), o status de conclusão do trabalho, o nome do tópico do SNS, o código de status do trabalho e o ARN do cofre. Veja a seguir um exemplo de notificação que o Amazon Glacier enviou para um tópico do SNS após a conclusão de um InventoryRetrieval trabalho.

{
 "Action": "InventoryRetrieval",
 "ArchiveId": null,
 "ArchiveSizeInBytes": null,
 "Completed": true,
 "CompletionDate": "2012-06-12T22:20:40.790Z",
 "CreationDate": "2012-06-12T22:20:36.814Z",
 "InventorySizeInBytes":11693,
 "JobDescription": "my retrieval job",
 "JobId":"HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID",
 "SHA256TreeHash":null,
 "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic",
 "StatusCode":"Succeeded",
 "StatusMessage": "Succeeded",
 "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
}    

Se o campo Completed for verdadeiro, você também deverá verificar o StatusCode para examinar se o trabalho foi concluído com êxito ou falhou.

Para obter mais informações sobre o Amazon SNS, consulte Conceitos básicos do Amazon SNS.