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

Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 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 sections Classes de stockage S3 Glacier et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent Amazon S3API, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de chiffrement optionnelles avancées, etc.

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 dans Amazon S3 Glacier

L'extraction de données depuis Amazon S3 Glacier, par exemple une archive d'un coffre ou un inventaire de coffre, 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 dans S3 Glacier : concepts généraux

Une demande de tâche d'extraction S3 Glacier s'exécute de manière asynchrone. Vous devez attendre que S3 Glacier ait terminé la tâche avant de pouvoir en obtenir la sortie. Vous pouvez interroger périodiquement S3 Glacier pour déterminer le statut de la tâche, mais il ne s'agit pas d'une approche optimale. S3 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 cette configuration, vous identifiez un ou plusieurs événements ainsi que la rubrique Amazon SNS vers laquelle vous voulez que S3 Glacier envoie un message lorsque l'événement se produit.

S3 Glacier définit des événements plus particulièrement liés à l'achèvement des tâches (ArchiveRetrievalCompleted, InventoryRetrievalCompleted), que vous pouvez ajouter à la configuration des notifications du coffre. Lorsqu'une tâche spécifique se termine, S3 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

Lorsqu'une configuration de notifications est ajoutée à un coffre, S3 Glacier envoie 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 configuration des notifications sur le coffre et que vous spécifiez aussi une rubrique Amazon SNS dans votre demande de lancement de tâche, S3 Glacier envoie les deux notifications.

Le message d'achèvement de tâche envoyé par S3 Glacier comprend des informations telles que le type de la tâche (InventoryRetrieval, ArchiveRetrieval), le statut d'achèvement de la tâche, le nom de la rubrique SNS, le code de statut de la tâche et l'ARN du coffre. L'exemple ci-dessous est le type de notification qu'envoie S3 Glacier à une rubrique SNS lorsqu'une tâche InventoryRetrieval se termine. 

{
 "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 Comptes AWS différents, vous devez configurer la rubrique Amazon SNS pour qu'elle accepte les publications en provenance 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.