**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.
# Définition d'une configuration de notification de coffre (PUT notification-configuration)
## Description
La récupération d'une archive et d'un inventaire du coffre est une opération asynchrone dans Amazon Glacier (Amazon Glacier) pour laquelle vous devez d'abord lancer une tâche et attendre que la tâche soit terminée avant de pouvoir télécharger le résultat de la tâche. Vous pouvez configurer un coffre pour qu'il publie un message dans une rubrique Amazon Simple Notification Service (Amazon SNS) une fois que ces tâches sont terminées. Vous pouvez utiliser cette opération pour définir une configuration de notification sur le coffre. Pour de plus amples informations, veuillez consulter [Configuration des notifications de coffre-fort dans Amazon Glacier](configuring-notifications.md).
Pour configurer des notifications de coffre, envoyez une demande PUT à la sous-ressource `notification-configuration` du coffre. Une configuration de notification est propre à un coffre ; par conséquent, elle est également appelée sous-ressource de coffre. La demande doit inclure un document JSON qui fournit une rubrique Amazon Simple Notification Service (Amazon SNS) et les événements pour lesquels vous souhaitez qu'Amazon Glacier envoie des notifications à cette rubrique.
Vous pouvez configurer un coffre afin qu'il publie une notification pour les événements de coffre suivants :
+ **`ArchiveRetrievalCompleted` :** cet événement se produit lorsqu'une tâche de lancement d'extraction d'archive se termine ([Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)). L'état de la tâche terminée peut être `Succeeded` ou `Failed`. La notification envoyée à la rubrique SNS est identique à la sortie renvoyée par une opération [Description de la tâche (GET JobID)](api-describe-job-get.md).
+ **`InventoryRetrievalCompleted` :** cet événement se produit lorsqu'une tâche de lancement d'extraction d'inventaire se termine ([Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)). L'état de la tâche terminée peut être `Succeeded` ou `Failed`. La notification envoyée à la rubrique SNS est identique à la sortie renvoyée par une opération [Description de la tâche (GET JobID)](api-describe-job-get.md).
Les rubriques Amazon SNS doivent autoriser le coffre à publier des notifications dans la rubrique.
## Requêtes
Pour définir une configuration de notification sur votre coffre, envoyez une demande PUT à l'URI de la sous-ressource `notification-configuration` du coffre. Vous spécifiez la configuration dans le corps de la demande. La configuration comprend le nom de la rubrique Amazon SNS et un tableau des événements qui déclenchent l'envoi d'une notification à chaque rubrique.
### Syntaxe
```
1. PUT /AccountId/vaults/VaultName/notification-configuration HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6.
7. {
8. "SNSTopic": String,
9. "Events":[String, ...]
10. }
```
**Note**
La `AccountId` valeur est l' Compte AWS ID du compte propriétaire du coffre-fort. Vous pouvez spécifier un Compte AWS identifiant ou éventuellement un seul « `-` » (trait d'union), auquel cas Amazon Glacier utilise l' Compte AWS identifiant associé aux informations d'identification utilisées pour signer la demande. Si vous utilisez un ID de compte, évitez d'y inclure des traits d'union (« - »).
### Paramètres de demande
Cette opération n'utilise pas les paramètres de demande.
### En-têtes de demande
Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez [En-têtes de demande communs](api-common-request-headers.md).
### Corps de la requête
Le code JSON contient les champs suivants dans le corps de la demande :
**Événements**
Ensemble d'un ou de plusieurs événements pour lesquels vous souhaitez qu'Amazon Glacier envoie une notification.
*Valeurs valides* : `ArchiveRetrievalCompleted` \$1 `InventoryRetrievalCompleted`
*Obligatoire* : oui
*Type* : tableau
**SNSTopic**
ARN de la rubrique Amazon SNS. Pour plus d'informations, accédez à [Démarrage avec Amazon SNS](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html) dans le *Guide de démarrage Amazon Simple Notification Service*.
*Obligatoire* : oui
*Type* : chaîne
## Réponses
En réponse, Amazon Glacier (Amazon Glacier) revient `204 No Content` si la configuration des notifications est acceptée.
### Syntaxe
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### En-têtes de réponse
Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez [En-têtes de demande communs](api-common-request-headers.md).
### Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
### Erreurs
Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md).
## Exemples
L'exemple suivant montre comment configurer la notification de coffre.
### Exemple de requête
La demande suivante définit la configuration des notifications de `examplevault` qui prévoit l'envoi de notifications pour deux événements (`ArchiveRetrievalCompleted` et `InventoryRetrievalCompleted`) à la rubrique Amazon SNS `arn:aws:sns:us-west-2:012345678901:mytopic`.
```
1. PUT /-/vaults/examplevault/notification-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
6.
7. {
8. "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"],
9. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
10. }
```
### Exemple de réponse
Une réponse positive renvoie le code de réponse `204 No Content`.
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Sections connexes
+ [Obtenir les notifications de coffre (GET notification-configuration)](api-vault-notifications-get.md)
+ [Supprimer les notifications de coffre (DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [Identity and Access Management pour Amazon Glacier](security-iam.md)
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-notifications.html)