**Esta página es solo para los clientes actuales del servicio Amazon Glacier que utilizan Vaults y la API de REST original de 2012.**
Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de Amazon Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte las [clases de almacenamiento de Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).
Amazon Glacier (servicio original independiente basado en bóveda) ya no acepta nuevos clientes. Amazon Glacier es un servicio independiente propio APIs que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las [clases de almacenamiento Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), que ofrecen una experiencia de cliente superior con S3 basada en cubos APIs, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra [AWS Guía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Establecimiento de la configuración de notificación del almacén (PUT configuración-notificaciones)
## Description (Descripción)
La recuperación de archivos e inventarios de almacén son operaciones asíncronas en Amazon Glacier (Amazon Glacier) por lo que, para poder descargar la salida de un trabajo, es necesario iniciarlo primero y esperar hasta que se complete. Puede configurar un almacén para que se publique un mensaje en un tema de Amazon Simple Notification Service (Amazon SNS) cuando estos trabajos se completen. Puede utilizar esta operación para definir la configuración de las notificaciones del almacén. Para obtener más información, consulte [Configuración de notificaciones de almacenes en Amazon Glacier](configuring-notifications.md).
Para configurar las notificaciones de un almacén, envíe una solicitud PUT al subrecurso `notification-configuration` del almacén. La configuración de las notificaciones es específica del almacén, por lo que también se conoce como "subrecurso del almacén". La solicitud debe incluir un documento JSON que contenga un tema de Amazon Simple Notification Service (Amazon SNS) y los eventos para los que quiere que Amazon Glacier envíe notificaciones al tema.
Puede configurar un almacén para que se publique una notificación de los siguientes eventos:
+ **`ArchiveRetrievalCompleted`:** este evento se produce cuando se completa un trabajo que se inició para recuperar un archivo ([Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md)). El estado del trabajo completado puede ser `Succeeded` o `Failed`. La notificación que se envía al tema de SNS es la misma salida que se devuelve de [Descripción del trabajo (GET JobID)](api-describe-job-get.md).
+ **`InventoryRetrievalCompleted`:** este evento se produce cuando se completa un trabajo que se inició para recuperar un inventario ([Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md)). El estado del trabajo completado puede ser `Succeeded` o `Failed`. La notificación que se envía al tema de SNS es la misma salida que se devuelve de [Descripción del trabajo (GET JobID)](api-describe-job-get.md).
Los temas de Amazon SNS deben conceder permiso al almacén para que pueda publicar notificaciones en el tema.
## Solicitudes
Para configurar las notificaciones de un almacén, envíe una solicitud PUT al URI del subrecurso `notification-configuration` del almacén. Debe especificar la configuración en el cuerpo de la solicitud. La configuración incluye el nombre del tema de Amazon SNS y una matriz de eventos que desencadenan las notificaciones en cada tema.
### Sintaxis
```
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. }
```
**nota**
El `AccountId` valor es el Cuenta de AWS identificador de la cuenta propietaria del almacén. Puede especificar un Cuenta de AWS ID o, si lo desea, un único `-` '' (guión), en cuyo caso Amazon Glacier utilizará el Cuenta de AWS ID asociado a las credenciales utilizadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.
### Parámetros de la solicitud
Esta operación no usa parámetros de solicitud.
### Encabezados de solicitud
Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte [Encabezados de solicitudes comunes](api-common-request-headers.md).
### Cuerpo de la solicitud
El código JSON del cuerpo de la solicitud contiene los siguientes campos.
**Events (Eventos)**
Matriz de uno o varios eventos para los que quiere que Amazon Glacier envíe una notificación.
*Valores válidos*: `ArchiveRetrievalCompleted` \$1 `InventoryRetrievalCompleted`
*Obligatorio*: sí
*Tipo*: Array
**SNSTopic**
ARN del tema de Amazon SNS. Para obtener más información, vaya a [Introducción a Amazon SNS](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html) en la *Guía de introducción de Amazon Simple Notification Service*.
*Obligatorio*: sí
*Tipo:* cadena
## Respuestas
Como respuesta, Amazon Glacier (Amazon Glacier) devuelve `204 No Content` si se acepta la configuración de las notificaciones.
### Sintaxis
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### Encabezados de respuesta
Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte [Encabezados de solicitudes comunes](api-common-request-headers.md).
### Cuerpo de respuesta
Esta operación no devuelve ningún cuerpo de respuesta.
### Errores
Para obtener información acerca de los mensajes de error y las excepciones de Amazon Glacier, consulte [Respuestas de error](api-error-responses.md).
## Ejemplos
En el ejemplo siguiente, se muestra cómo se configuran las notificaciones de un almacén.
### Solicitud de ejemplo
La siguiente solicitud configura las notificaciones de `examplevault` para que se envíen notificaciones de dos eventos (`ArchiveRetrievalCompleted` e `InventoryRetrievalCompleted`) al tema de 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. }
```
### Respuesta de ejemplo
Si la respuesta es correcta, devuelve `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
```
## Secciones relacionadas
+ [Obtención de notificaciones del almacén (GET configuración-notificaciones)](api-vault-notifications-get.md)
+ [Eliminación de las notificaciones del almacén (DELETE configuración-notificaciones)](api-vault-notifications-delete.md)
+ [Administración de identidades y accesos para Amazon Glacier](security-iam.md)
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos de Amazon SDKs, consulta lo siguiente:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-notifications.html)