Configurar notificações do cofre no Amazon Glacier - Amazon Glacier
Conceitos gerais

Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.

Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do 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 Classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. 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 nossas Orientações de soluções da AWS 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á.

Configurar notificações do cofre no Amazon Glacier

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

  1. Inicie um trabalho de recuperação.

  2. Após a conclusão do trabalho, faça o download da saída do mesmo.

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

Tópicos

Configurar notificações de cofre no Amazon Glacier: conceitos gerais

Uma solicitação de trabalho de recuperação do Amazon Glacier é executada de maneira assíncrona. Você deve aguardar até que o Amazon Glacier conclua o trabalho para obter a saída. Você pode sondar 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, é possível identificar um ou mais eventos e um tópico do Amazon SNS para o qual você quer 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 no 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.

nota

Adicionar uma configuração de notificação a um cofre faz o Amazon Glacier enviar uma notificação sempre que o evento especificado na configuração de notificação ocorrer. Você também pode especificar um tópico do Amazon SNS em cada solicitação de iniciação do trabalho. Se você adicionar a configuração de notificação no cofre e também especificar um tópico do Amazon SNS na solicitação do trabalho de iniciação, o Amazon Glacier enviará ambas as notificações.

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. Esta é uma notificação de exemplo que o Amazon Glacier enviou para um tópico do SNS após a conclusão de um trabalho InventoryRetrieval. 

{
 "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.

nota

O tópico do Amazon SNS deve permitir que o cofre publique uma notificação. Por padrão, somente o proprietário do tópico do Amazon SNS pode publicar uma mensagem no tópico. Porém, se o tópico do Amazon SNS e o cofre forem de propriedade de contas diferentes da Contas da AWS, você deverá configurar o tópico do Amazon SNS para aceitar publicações de cofre. Você pode configurar a política de tópico do Amazon SNS no console do Amazon SNS.

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