Esta página es solo para los clientes actuales del servicio S3 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 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
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.
Descarga de un inventario de almacén en Amazon S3 Glacier
Después de cargar un primer archivo en el almacén, Amazon S3 Glacier (S3 Glacier) crea automáticamente un inventario de almacén y, después, lo actualiza aproximadamente una vez al día. Una vez que S3 Glacier crea el primer inventario, normalmente debe transcurrir entre medio día y un día para que el inventario pueda recuperarse. Para recuperar un inventario de almacén de S3 Glacier, puede utilizar este proceso de dos pasos:
-
Inicie un trabajo de recuperación de inventario utilizando la operación Inicialización de trabajos (POST trabajos).
importante
Si se utiliza una política de recuperación de datos, puede producirse una excepción
PolicyEnforcedExceptionen la solicitud de inicio del trabajo de recuperación. Para obtener más información sobre las políticas de recuperación de datos, consulte Políticas de recuperación de datos de S3 Glacier. Para obtener más información sobre la excepciónPolicyEnforcedException, consulte Respuestas de error. -
Una vez completado el trabajo, descargue los bytes utilizando la operación Obtención de la salida del trabajo (GET output).
Por ejemplo, para poder recuperar un archivo o un inventario de almacén, primero es necesario iniciar un trabajo de recuperación. La solicitud del trabajo se ejecuta de forma asincrónica. Cuando se inicia un trabajo de recuperación, S3 Glacier crea un trabajo y devuelve un ID de trabajo en la respuesta. Una vez que S3 Glacier finaliza el trabajo, se puede obtener la salida del trabajo, los bytes del archivo o los datos del inventario del almacén.
El trabajo debe completarse antes de poder obtener la salida. Para determinar el estado del trabajo, cuenta con las siguientes opciones:
-
Esperar una notificación de finalización del trabajo: puede especificar un tema de Amazon Simple Notification Service (Amazon SNS) en el que S3 Glacier puede publicar una notificación cuando se complete el trabajo. Para especificar un tema de Amazon SNS, puede utilizar los siguientes métodos:
Puede especificar un tema de Amazon SNS en cada trabajo.
Cuando inicie un trabajo, si lo desea, puede especificar un tema de Amazon SNS.
Puede configurar las notificaciones en el almacén.
Puede configurar las notificaciones para determinados eventos en el almacén (consulte Configuración de las notificaciones de almacén en Amazon S3 Glacier). S3 Glacier envía un mensaje al tema de SNS especificado siempre que se produce ese evento específico.
Si ha configurado las notificaciones en el almacén y ha especificado además un tema de Amazon SNS al iniciar un trabajo, S3 Glacier envía un mensaje de finalización del trabajo a ambos temas.
Puede configurar el tema de SNS para que le envíe las notificaciones a través del correo electrónico o almacenar el mensaje en una instancia de Amazon Simple Queue Service (Amazon SQS) que la aplicación puede sondear. Cuando aparece un mensaje en la cola, puede comprobar si el trabajo se ha completado correctamente y, a continuación, descargar la salida del trabajo.
-
Solicitar explícitamente información del trabajo: S3 Glacier también proporciona una operación para describir el trabajo (Descripción del trabajo (GET JobID)) que le permite sondear información sobre el trabajo. Puede enviar periódicamente esta solicitud para obtener información sobre el trabajo. No obstante, la opción recomendada es utilizar las notificaciones de Amazon SNS.
nota
La información que se obtiene través de las notificaciones de SNS es la misma que se obtiene llamando a Describe Job.
Temas
Acerca del inventario
A partir del día que se carga por primera vez un archivo en el almacén, S3 Glacier actualiza el inventario del almacén al menos una vez al día. Si no se han agregando ni eliminado archivos en el almacén desde el último inventario, la fecha del inventario no se actualiza. Cuando se inicia un trabajo para un inventario del almacén, S3 Glacier devuelve el último inventario generado, que es una instantánea realizada en un momento dado y no contiene datos en tiempo real. Tenga en cuenta que, una vez que S3 Glacier crea el primer inventario de almacén, debe transcurrir entre medio día y un día para que el inventario pueda recuperarse.
Es posible que no le parezca útil recuperar un inventario del almacén cada vez que carga un archivo. Sin embargo, imagine que tiene una base de datos del cliente que asocia los metadatos de los archivos que se cargan en S3 Glacier. En ese caso, el inventario del almacén podría resultarle útil para, en función de sus necesidades, conciliar la información de la base de datos con el inventario del almacén real. Puede limitar el número de elementos del inventario que se van a recuperar utilizando como filtro la fecha de creación del archivo o definiendo una cuota. Para obtener más información sobre la limitación de la recuperación de inventario, consulte Recuperación del inventario por intervalos.
El inventario se puede devolver con dos formatos: valores separados por comas (CSV) o JSON. Si lo desea, puede especificar el formato al iniciar el trabajo de inventario. El formato predeterminado es JSON. Para obtener más información acerca de los campos de datos que se devuelven en la salida de un trabajo de inventario, consulte Cuerpo de respuesta en la API Get Job Output (Obtener salida de trabajo).
