Configuration des notifications de coffre-fort dans Amazon Glacier - Amazon Glacier
Concepts généraux

Cette page est réservée aux clients existants du service Amazon Glacier utilisant Vaults et l'API REST d'origine datant de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous recommandons d'utiliser les classes de stockage Amazon Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les classes de stockage Amazon Glacier.

Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'acceptera plus de nouveaux clients à compter du 15 décembre 2025, sans aucune incidence sur les clients existants. Amazon Glacier est un service autonome doté de son propre service APIs qui stocke les données dans des coffres-forts et qui se distingue des classes de stockage Amazon S3 et Amazon S3 Glacier. Vos données existantes resteront sécurisées et accessibles indéfiniment dans Amazon Glacier. Aucune migration n'est requise. Pour un stockage d'archivage à long terme et à faible coût AWS , nous recommandons les classes de stockage Amazon S3 Glacier, qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration des notifications de coffre-fort dans Amazon Glacier

La récupération de tout élément d'Amazon Glacier, tel qu'une archive d'un coffre-fort ou un inventaire de coffre-fort, est un processus en deux étapes.

  1. Lancez une tâche d'extraction.

  2. Une fois la tâche terminée, téléchargez la sortie correspondante.

Vous pouvez définir une configuration de notifications sur un coffre de sorte qu'un message soit envoyé à une rubrique Amazon Simple Notification Service (Amazon SNS) dès qu'une tâche se termine.

Rubriques

Configuration des notifications de coffre-fort dans Amazon Glacier : concepts généraux

Une demande de travail de récupération Amazon Glacier est exécutée de manière asynchrone. Vous devez attendre qu'Amazon Glacier ait terminé le travail avant de pouvoir obtenir ses résultats. Vous pouvez régulièrement interroger Amazon Glacier pour déterminer le statut de la tâche, mais cette approche n'est pas optimale. Amazon Glacier prend également en charge les notifications. Lorsqu'une tâche se termine, elle peut publier un message dans une rubrique Amazon Simple Notification Service (Amazon SNS). Pour pouvoir utiliser cette fonctionnalité, vous devez définir une configuration de notifications sur le coffre. Dans la configuration, vous identifiez un ou plusieurs événements et une rubrique Amazon SNS à laquelle vous souhaitez qu'Amazon Glacier envoie un message lorsque l'événement se produit.

Amazon Glacier définit les événements spécifiquement liés à l'achèvement des tâches (ArchiveRetrievalCompleted,InventoryRetrievalCompleted) que vous pouvez ajouter à la configuration des notifications du coffre-fort. Lorsqu'une tâche spécifique est terminée, Amazon Glacier publie un message de notification dans la rubrique SNS.

La configuration de notification est un document JSON comme illustré dans l'exemple suivant. 

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

Vous ne pouvez configurer qu'une seule rubrique Amazon SNS par coffre.

Note

L'ajout d'une configuration de notification à un coffre-fort oblige Amazon Glacier à envoyer une notification chaque fois que l'événement spécifié dans la configuration des notifications se produit. Vous pouvez également spécifier une rubrique Amazon SNS dans chaque demande de lancement de tâche. Si vous ajoutez à la fois la configuration des notifications dans le coffre et que vous spécifiez une rubrique Amazon SNS dans votre demande de travail d'initiation, Amazon Glacier envoie les deux notifications.

Le message d'achèvement de la tâche envoyé par Amazon Glacier inclut des informations telles que le type de tâche (InventoryRetrieval,ArchiveRetrieval), l'état d'achèvement de la tâche, le nom de la rubrique SNS, le code d'état de la tâche et l'ARN du coffre-fort. Voici un exemple de notification envoyée par Amazon Glacier à une rubrique SNS après la fin d'une InventoryRetrieval tâche. 

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

Si le champ Completed a pour valeur true, vous devez également contrôler la valeur du champ StatusCode afin de vérifier si la tâche a abouti ou échoué.

Note

La rubrique Amazon SNS doit autoriser le coffre à publier une notification. Par défaut, seul le propriétaire de la rubrique Amazon SNS peut publier un message dans cette rubrique. Toutefois, si la rubrique Amazon SNS et le coffre appartiennent à des propriétaires différents Comptes AWS, vous devez configurer la rubrique Amazon SNS pour accepter les publications du coffre. Vous pouvez configurer la politique de rubrique Amazon SNS dans la console Amazon SNS.

Pour plus d'informations sur Amazon SNS, consultez Démarrage avec Amazon SNS.