Configuración de las notificaciones de almacén en Amazon S3 Glacier - Amazon S3 Glacier
Conceptos generales

Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y el original de 2012. REST API

Si busca soluciones de almacenamiento de archivos, le sugerimos que utilice las clases de almacenamiento S3 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 Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan Amazon S3API, están disponibles en todas las regiones y se pueden gestionar en la consola de Amazon S3. Ofrecen funciones como el análisis de costos de almacenamiento, Storage Lens, funciones avanzadas de cifrado opcionales y más.

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.

Configuración de las notificaciones de almacén en Amazon S3 Glacier

El proceso para recuperar cualquier elemento de Amazon S3 Glacier, como un archivo o un inventario de almacén, consta de dos pasos.

  1. Inicio del trabajo de recuperación.

  2. Una vez completado el trabajo, descargue la salida de este.

Puede configurar las notificaciones de un almacén para que, cuando se complete un trabajo, se envíe un mensaje a un tema de Amazon Simple Notification Service (Amazon SNS).

Temas

Configuración de notificaciones de almacén en S3 Glacier: conceptos generales

Las solicitudes de los trabajos de recuperación de S3 Glacier se ejecutan de forma asíncrona. Debe esperar hasta que S3 Glacier complete el trabajo para poder obtener la salida. Puede sondear S3 Glacier periódicamente para determinar el estado del trabajo, pero no es el enfoque más adecuado. S3 Glacier también admite las notificaciones. Cuando se completa un trabajo, este puede publicar un mensaje en un tema de Amazon Simple Notification Service (Amazon SNS). Para usar esta característica, es necesario que configure las notificaciones en el almacén. En la configuración, identifique uno o varios eventos y el tema de Amazon SNS al que quiere que S3 Glacier envíe un mensaje cuando se produzca el evento.

S3 Glacier define eventos relacionados específicamente con la finalización de un trabajo (ArchiveRetrievalCompleted, InventoryRetrievalCompleted) que se pueden añadir a la configuración de las notificaciones de un almacén. Cuando se completa un determinado trabajo, S3 Glacier publica un mensaje de notificación en el tema de SNS.

En el siguiente ejemplo, se muestra la configuración de las notificaciones de un documento JSON. 

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

Solamente puede configurar un tema de Amazon SNS en cada almacén.

nota

Si agrega la configuración de las notificaciones a un almacén, S3 Glacier enviará una notificación cada vez que se produzca el evento especificado en dicha configuración. Si lo desea, también puede especificar un tema de Amazon SNS en cada solicitud de inicio de trabajo. Si añade la configuración de las notificaciones en el almacén y especifica también un tema de Amazon SNS en la solicitud de inicio del trabajo, S3 Glacier envía ambas notificaciones.

El mensaje de finalización del trabajo que S3 Glacier envía contiene cierta información, como el tipo de trabajo (InventoryRetrieval, ArchiveRetrieval), el estado de finalización del trabajo, el nombre del tema de SNS, el código de estado del trabajo y el ARN del almacén. A continuación, se muestra una notificación de ejemplo que S3 Glacier envía a un tema de SNS tras la finalización de un trabajo InventoryRetrieval. 

{
 "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 el campo Completed es true, también debe comprobar StatusCode para determinar si el trabajo se completó correctamente o con errores.

nota

Tenga en cuenta que el tema de Amazon SNS debe permitir que el almacén publique notificaciones. De forma predeterminada, solo el propietario del tema de Amazon SNS puede publicar un mensaje en ese tema. Sin embargo, si el tema de Amazon SNS y el almacén son propiedad de diferentes Cuentas de AWS, el tema de Amazon SNS debe configurarse para que pueda aceptar publicaciones del almacén. Puede configurar la política de temas de SNS en la consola de Amazon SNS.

Para obtener más información sobre Amazon SNS, consulte Introducción a Amazon SNS.