**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](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. 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](https://aws.amazon.com/s3/storage-classes/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](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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. 1. 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. **Topics** + [ ## Configuration des notifications de coffre-fort dans Amazon Glacier : concepts généraux ](#configuring-notifications.general) + [ # Configuration des notifications de coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour Java ](configuring-notifications-sdk-java.md) + [ # Configuration des notifications de coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour .NET ](configuring-notifications-sdk-dotnet.md) + [ # Configuration des notifications Vault dans Amazon Glacier à l'aide de l'API REST ](configuring-notifications-rest-api.md) + [ # Configuration des notifications Vault à l'aide de la console Amazon Glacier ](configuring-notifications-console.md) + [ # Configuration des notifications du coffre-fort à l'aide du AWS Command Line Interface ](configuring-notifications-cli.md) ## 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](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html). # Configuration des notifications de coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour Java Voici les étapes pour configurer des notifications sur un coffre à l'aide de l'API de bas niveau de AWS SDK pour Java. 1. Créez une instance de la classe `AmazonGlacierClient` (le client). Vous devez spécifier AWS la région dans laquelle se trouve le coffre. Toutes les opérations que vous effectuez à l'aide de ce client s'appliquent à cette AWS région. 1. Indiquez les informations sur la configuration de notification en créant une instance de la classe `SetVaultNotificationsRequest`. Vous devez fournir le nom du coffre, les informations sur la configuration de notification et l'ID de compte. En spécifiant une configuration de notification, vous fournissez l'Amazon Resource Name (ARN) d'une rubrique Amazon SNS existante et un ou plusieurs événements pour lesquels vous souhaitez être notifié. Pour obtenir la liste des événements pris en charge, consultez la section [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md). 1. Exécutez la méthode `setVaultNotifications` en fournissant l'objet de demande comme paramètre. L'extrait de code Java suivant illustre les étapes précédentes. Cet extrait définit une configuration de notification sur un coffre. La configuration demande à Amazon Glacier (Amazon Glacier) d'envoyer une notification à la rubrique Amazon SNS spécifiée lorsque l'`ArchiveRetrievalCompleted`événement ou l'`InventoryRetrievalCompleted`événement se produit. ``` SetVaultNotificationsRequest request = new SetVaultNotificationsRequest() .withAccountId("-") .withVaultName("*** provide vault name ***") .withVaultNotificationConfig( new VaultNotificationConfig() .withSNSTopic("*** provide SNS topic ARN ***") .withEvents("ArchiveRetrievalCompleted", "InventoryRetrievalCompleted") ); client.setVaultNotifications(request); ``` **Note** Pour obtenir des informations sur l'API REST sous-jacente, consultez la section [Opérations de coffre](vault-operations.md). ## Exemple : Configuration de la configuration des notifications sur un coffre-fort à l'aide du AWS SDK pour Java L'exemple de code Java suivant définit la configuration des notifications d'un coffre, la supprime, puis la restaure. Pour step-by-step obtenir des instructions sur la façon d'exécuter l'exemple suivant, reportez-vous à[Utilisation du AWS SDK pour Java avec Amazon Glacier](using-aws-sdk-for-java.md). **Example** ``` import java.io.IOException; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.glacier.AmazonGlacierClient; import com.amazonaws.services.glacier.model.DeleteVaultNotificationsRequest; import com.amazonaws.services.glacier.model.GetVaultNotificationsRequest; import com.amazonaws.services.glacier.model.GetVaultNotificationsResult; import com.amazonaws.services.glacier.model.SetVaultNotificationsRequest; import com.amazonaws.services.glacier.model.VaultNotificationConfig; public class AmazonGlacierVaultNotifications { public static AmazonGlacierClient client; public static String vaultName = "*** provide vault name ****"; public static String snsTopicARN = "*** provide sns topic ARN ***"; public static void main(String[] args) throws IOException { ProfileCredentialsProvider credentials = new ProfileCredentialsProvider(); client = new AmazonGlacierClient(credentials); client.setEndpoint("https://glacier.us-east-1.amazonaws.com/"); try { System.out.println("Adding notification configuration to the vault."); setVaultNotifications(); getVaultNotifications(); deleteVaultNotifications(); } catch (Exception e) { System.err.println("Vault operations failed." + e.getMessage()); } } private static void setVaultNotifications() { VaultNotificationConfig config = new VaultNotificationConfig() .withSNSTopic(snsTopicARN) .withEvents("ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"); SetVaultNotificationsRequest request = new SetVaultNotificationsRequest() .withVaultName(vaultName) .withVaultNotificationConfig(config); client.setVaultNotifications(request); System.out.println("Notification configured for vault: " + vaultName); } private static void getVaultNotifications() { VaultNotificationConfig notificationConfig = null; GetVaultNotificationsRequest request = new GetVaultNotificationsRequest() .withVaultName(vaultName); GetVaultNotificationsResult result = client.getVaultNotifications(request); notificationConfig = result.getVaultNotificationConfig(); System.out.println("Notifications configuration for vault: " + vaultName); System.out.println("Topic: " + notificationConfig.getSNSTopic()); System.out.println("Events: " + notificationConfig.getEvents()); } private static void deleteVaultNotifications() { DeleteVaultNotificationsRequest request = new DeleteVaultNotificationsRequest() .withVaultName(vaultName); client.deleteVaultNotifications(request); System.out.println("Notifications configuration deleted for vault: " + vaultName); } } ``` # Configuration des notifications de coffre-fort dans Amazon Glacier à l'aide du AWS SDK pour .NET Voici les étapes pour configurer des notifications sur un coffre à l'aide de l'API de bas niveau de AWS SDK pour .NET. 1. Créez une instance de la classe `AmazonGlacierClient` (le client). Vous devez spécifier AWS la région dans laquelle se trouve le coffre. Toutes les opérations que vous effectuez à l'aide de ce client s'appliquent à cette AWS région. 1. Indiquez les informations sur la configuration de notification en créant une instance de la classe `SetVaultNotificationsRequest`. Vous devez fournir le nom du coffre, les informations sur la configuration de notification et l'ID de compte. Si vous n'indiquez pas d'ID de compte, l'ID de compte associé aux informations d'identification que vous avez indiquées pour signer la demande est pris en compte. Pour de plus amples informations, veuillez consulter [Utilisation du AWS SDK pour .NET avec Amazon Glacier](using-aws-sdk-for-dot-net.md). En spécifiant une configuration de notification, vous fournissez l'Amazon Resource Name (ARN) d'une rubrique Amazon SNS existante et un ou plusieurs événements pour lesquels vous souhaitez être notifié. Pour obtenir la liste des événements pris en charge, consultez la section [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md). 1. Exécutez la méthode `SetVaultNotifications` en fournissant l'objet de demande comme paramètre. 1. Après avoir défini une configuration de notification sur un coffre, vous pouvez extraire les informations sur la configuration en appelant la méthode `GetVaultNotifications` et les retirer en appelant la méthode `DeleteVaultNotifications` fournie par le client. ## Exemple : Configuration de la configuration des notifications sur un coffre-fort à l'aide du AWS SDK pour .NET L'exemple de code C\$1 suivant présente les étapes précédentes. L'exemple définit la configuration de notifications pour le coffre (« `examplevault` ») de la région USA Ouest (Oregon), extrait la configuration, puis la supprime. La configuration demande à Amazon Glacier (Amazon Glacier) d'envoyer une notification à la rubrique Amazon SNS spécifiée lorsque l'`ArchiveRetrievalCompleted`événement ou l'`InventoryRetrievalCompleted`événement se produit. **Note** Pour obtenir des informations sur l'API REST sous-jacente, consultez la section [Opérations de coffre](vault-operations.md). Pour step-by-step obtenir des instructions relatives à l'exécution de l'exemple suivant, reportez-vous à[Exemples de code en cours d'exécution](using-aws-sdk-for-dot-net.md#setting-up-and-testing-sdk-dotnet). Vous devez mettre à jour le code tel qu'il est présenté et fournir un nom de coffre existant et une rubrique Amazon SNS. **Example** ``` using System; using System.Collections.Generic; using Amazon.Glacier; using Amazon.Glacier.Model; using Amazon.Runtime; namespace glacier.amazon.com.rproxy.govskope.ca.docsamples { class VaultNotificationSetGetDelete { static string vaultName = "examplevault"; static string snsTopicARN = "*** Provide Amazon SNS topic ARN ***"; static IAmazonGlacier client; public static void Main(string[] args) { try { using (client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2)) { Console.WriteLine("Adding notification configuration to the vault."); SetVaultNotificationConfig(); GetVaultNotificationConfig(); Console.WriteLine("To delete vault notification configuration, press Enter"); Console.ReadKey(); DeleteVaultNotificationConfig(); } } catch (AmazonGlacierException e) { Console.WriteLine(e.Message); } catch (AmazonServiceException e) { Console.WriteLine(e.Message); } catch (Exception e) { Console.WriteLine(e.Message); } Console.WriteLine("To continue, press Enter"); Console.ReadKey(); } static void SetVaultNotificationConfig() { SetVaultNotificationsRequest request = new SetVaultNotificationsRequest() { VaultName = vaultName, VaultNotificationConfig = new VaultNotificationConfig() { Events = new List() { "ArchiveRetrievalCompleted", "InventoryRetrievalCompleted" }, SNSTopic = snsTopicARN } }; SetVaultNotificationsResponse response = client.SetVaultNotifications(request); } static void GetVaultNotificationConfig() { GetVaultNotificationsRequest request = new GetVaultNotificationsRequest() { VaultName = vaultName, AccountId = "-" }; GetVaultNotificationsResponse response = client.GetVaultNotifications(request); Console.WriteLine("SNS Topic ARN: {0}", response.VaultNotificationConfig.SNSTopic); foreach (string s in response.VaultNotificationConfig.Events) Console.WriteLine("Event : {0}", s); } static void DeleteVaultNotificationConfig() { DeleteVaultNotificationsRequest request = new DeleteVaultNotificationsRequest() { VaultName = vaultName }; DeleteVaultNotificationsResponse response = client.DeleteVaultNotifications(request); } } } ``` # Configuration des notifications Vault dans Amazon Glacier à l'aide de l'API REST Pour configurer des notifications de coffre à l'aide de l'API REST, consultez la section [Définition d'une configuration de notification de coffre (PUT notification-configuration)](api-vault-notifications-put.md). En outre, vous pouvez également extraire des notifications de coffre ([Obtenir les notifications de coffre (GET notification-configuration)](api-vault-notifications-get.md)) et supprimer des notifications de coffre ([Supprimer les notifications de coffre (DELETE notification-configuration)](api-vault-notifications-delete.md)). # Configuration des notifications Vault à l'aide de la console Amazon Glacier Cette section explique comment configurer les notifications de coffre-fort à l'aide de la console Amazon Glacier. Lorsque vous configurez des notifications, vous spécifiez les événements d'achèvement de tâche qui envoient une notification à une rubrique Amazon Simple Notification Service (Amazon SNS). En plus de configurer des notifications pour le coffre, vous pouvez aussi spécifier la rubrique dans laquelle les notifications seront publiées au lancement d'une tâche. Si votre coffre est configuré pour envoyer une notification pour un événement spécifique et que vous configurez également des notifications dans la demande de lancement de tâche, deux notifications sont envoyées. **Pour configurer une notification de coffre** 1. Connectez-vous à la console Amazon Glacier AWS Management Console et ouvrez-la [https://console.aws.amazon.com/glacier/chez](https://console.aws.amazon.com/glacier/home) vous. 1. Dans le panneau de navigation de gauche, choisissez **Coffres**. 1. Dans la liste des **coffres**, choisissez un coffre. 1. Dans la section **Notifications**, choisissez **Modifier**. 1. Sur la page **Notifications d'événements**, choisissez **Activer les notifications**. 1. Dans la section **Notifications**, choisissez l'une des options Amazon Simple Notification Service (Amazon SNS) suivantes, puis suivez les étapes correspondantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/amazonglacier/latest/dev/configuring-notifications-console.html) 1. Sous **Événements**, sélectionnez l'événement (ou les deux) qui va déclencher l'envoi de notifications : + Pour n'envoyer une notification qu'à l'achèvement d'une tâche d'extraction d'archive, sélectionnez **Tâche d'extraction d'archives effectuée**. + Pour n'envoyer une notification qu'à l'achèvement d'une tâche d'inventaire de coffre, sélectionnez **Tâche d'extraction d'inventaires de coffre effectuée**. # Configuration des notifications du coffre-fort à l'aide du AWS Command Line Interface Cette section explique comment configurer des notifications de coffre à l'aide de l' AWS Command Line Interface. Lorsque vous configurez des notifications, vous spécifiez les événements d'achèvement de tâche qui déclenchent une notification vers une rubrique Amazon Simple Notification Service (Amazon SNS). En plus de configurer des notifications pour le coffre, vous pouvez également spécifier une rubrique vers laquelle publier une notification lorsque vous lancez une tâche. Si votre coffre est configuré pour avertir d'un événement spécifique et que vous spécifiez une notification dans la demande de lancement de tâche, deux notifications sont envoyées. Pour configurer des notifications de coffre à l'aide de l'interface AWS CLI, procédez comme suit. **Topics** + [ ## (Prérequis) Configuration du AWS CLI ](#Creating-Vaults-CLI-Setup) + [ ## Exemple : configurer les notifications du coffre-fort à l'aide du AWS CLI ](#Configure-Vault-Notifications-CLI-Implementation) ## (Prérequis) Configuration du AWS CLI 1. Téléchargez et configurez l’interface AWS CLI. Pour obtenir des instructions, consultez les rubriques suivantes dans le *Guide de l’utilisateur de l’interface AWS Command Line Interface * : [Installation du AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) [Configuration du AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) 1. Vérifiez votre AWS CLI configuration en saisissant les commandes suivantes à l'invite de commande. Ces commandes ne fournissent pas directement d'informations d'identification, par conséquent ce sont les informations du profil par défaut qui sont utilisées. + Essayez d'utiliser la commande help. ``` aws help ``` + Pour obtenir la liste des coffres-forts Amazon Glacier sur le compte configuré, utilisez la `list-vaults` commande. *123456789012*Remplacez-le par votre Compte AWS identifiant. ``` aws glacier list-vaults --account-id 123456789012 ``` + Pour voir les données de configuration actuelles pour le AWS CLI, utilisez la `aws configure list` commande. ``` aws configure list ``` ## Exemple : configurer les notifications du coffre-fort à l'aide du AWS CLI 1. Utilisez la commande `set-vault-notifications` pour configurer les notifications qui seront envoyées lorsque des événements spécifiques se produiront sur un coffre. Par défaut, vous ne recevez pas de notifications. ``` aws glacier set-vault-notifications --vault-name examplevault --account-id 111122223333 --vault-notification-config file://notificationconfig.json ``` 1. 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"] } ``` Pour plus d'informations sur l'utilisation des rubriques Amazon SNS pour Amazon Glacier, consultez [Configuration des notifications de coffre-fort dans Amazon Glacier : concepts généraux](configuring-notifications.html#configuring-notifications.general) Pour plus d'informations sur Amazon SNS, consultez [Démarrage avec Amazon SNS](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html).