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

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

Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 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 Classes de armazenamento S3 Glacier e Armazenamento de dados de longo prazo usando classes de armazenamento S3 Glacier no Guia do usuário do Amazon S3. Essas classes de armazenamento usam o Amazon S3API, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Eles oferecem recursos como análise de custos de armazenamento, lente de armazenamento, recursos avançados de criptografia opcional e muito mais.

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 de cofre no Amazon S3 Glacier

Recuperar qualquer dado do Amazon S3 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 S3 Glacier: conceitos gerais

Uma solicitação de trabalho de recuperação do S3 Glacier é executada de maneira assíncrona. Você deve aguardar que o S3 Glacier conclua o trabalho para obter a saída. Periodicamente, você pode sondar o S3 Glacier para determinar o status do trabalho, mas essa não é uma abordagem ideal. O S3 Glacier também oferece suporte para 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ê deseja que o S3 Glacier envie uma mensagem quando o evento ocorrer.

O S3 Glacier define eventos especificamente relacionados à conclusão da tarefa (ArchiveRetrievalCompleted, InventoryRetrievalCompleted) que você pode adicionar à configuração de notificação do cofre. Quando um trabalho específico é concluído, o S3 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 S3 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 S3 Glacier enviará ambas as notificações.

A mensagem de conclusão do trabalho que o S3 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 S3 Glacier enviou para um tópico do SNS após a InventoryRetrieval conclusão de um 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.

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.