Descarga de un inventario de almacén en Amazon S3 Glacier - Amazon S3 Glacier
Acerca del inventario

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.

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:

  1. Inicie un trabajo de recuperación de inventario utilizando la operación Iniciar trabajo (POSTtrabajos).

    importante

    Si se utiliza una política de recuperación de datos, puede producirse una excepción PolicyEnforcedException en 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ón PolicyEnforcedException, consulte Respuestas de error.

  2. 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:

  • Espere la notificación de finalización del trabajo: puede especificar un tema de Amazon Simple Notification Service (AmazonSNS) en el que S3 Glacier pueda publicar una notificación una vez finalizado el trabajo. Puedes especificar el SNS tema de Amazon mediante los siguientes métodos:

    • Especifica un SNS tema de Amazon por puesto de trabajo.

      Al iniciar un trabajo, si lo desea, puede especificar un SNS tema de Amazon.

    • 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 SNS tema especificado cada vez que se produce el evento específico.

    Si tiene una configuración de notificaciones establecida en el almacén y también especifica un SNS tema de Amazon al iniciar un trabajo, S3 Glacier envía un mensaje de finalización del trabajo a ambos temas.

    Puede configurar el SNS tema para que se lo notifique por correo electrónico o almacenar el mensaje en un Amazon Simple Queue Service (AmazonSQS) que su aplicación pueda 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. Sin embargo, la opción recomendada es utilizar las SNS notificaciones de Amazon.

nota

La información que obtiene mediante SNS una notificación es la misma que obtiene al llamar a Describe Job.

Temas

Acerca del inventario

S3 Glacier actualiza el inventario de un almacén al menos una vez al día, a partir del día en que se carga un archivo al almacén por primera vez. Si no se han agregando ni eliminado archivos en el almacén desde el último inventario, la fecha del inventario no se actualiza. Al iniciar un trabajo de inventario de almacenes, S3 Glacier devuelve el último inventario que generó, que es una point-in-time instantánea y no 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 en 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 sobre los campos de datos devueltos en una salida de trabajo Cuerpo de respuesta de inventario, consulte Obtener salida de trabajo API.