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
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.
Trabajar con archivos en Amazon S3 Glacier
Un archivo es cualquier objeto (por ejemplo, una foto, un vídeo o un documento) que se guarda en un almacén. Es una unidad base de almacenamiento en Amazon S3 Glacier (S3 Glacier). Cada archivo de almacenamiento tiene un identificador único y una descripción opcional. Al cargar un archivo, S3 Glacier devuelve una respuesta que incluye un ID de archivo. Este ID de archivo es único en la región de AWS en la que se almacena el archivo. A continuación se muestra un ejemplo de ID de archivo.
TJgHcrOSfAkV6hdPqOATYfp_0ZaxL1pIBOc02iZ0gDPMr2ig-nhwd_PafstsdIf6HSrjHnP-3p6LCJClYytFT_CBhT9CwNxbRaM5MetS3I-GqwxI3Y8QtgbJbhEQPs0mJ3KExample
Los ID de archivo tienen una longitud de 138 bytes. Al cargar un archivo, puede proporcionar una descripción opcional. Puede recuperar un archivo mediante su ID, pero no su descripción.
importante
S3 Glacier dispone de una consola de administración. Puede utilizar la consola para crear y eliminar almacenes. Sin embargo, todas las demás interacciones que realice con S3 Glacier deben hacerse con la AWS Command Line Interface (CLI) o mediante la escritura de código. Por ejemplo, si quiere cargar datos (como fotos, vídeos y otros documentos), debe utilizar la AWS CLI o escribir código para realizar las solicitudes a través de la API de REST directamente o a través de los SDK de Amazon. Para obtener más información sobre el uso de S3 Glacier con la AWS CLI, consulte la Referencia de la AWS CLI para S3 Glacier. Para instalar la AWS CLI, visite AWS Command Line Interface
Temas
Operaciones de archivo en Amazon S3 Glacier
S3 Glacier admite las siguientes operaciones de archivo básicas: cargar, descargar y eliminar. La descarga de un archivo es asíncrona.
Carga de un archivo en Amazon S3 Glacier
Puede cargar un archivo en una sola operación o cargarlo por partes. La llamada a la API que utiliza para cargar un archivo por partes se conoce como carga multiparte. Para obtener más información, consulte Carga de un archivo en Amazon S3 Glacier.
importante
S3 Glacier dispone de una consola de administración. Puede utilizar la consola para crear y eliminar almacenes. Sin embargo, todas las demás interacciones que realice con S3 Glacier deben hacerse con la AWS Command Line Interface (CLI) o mediante la escritura de código. Por ejemplo, si quiere cargar datos (como fotos, vídeos y otros documentos), debe utilizar la AWS CLI o escribir código para realizar las solicitudes a través de la API de REST directamente o a través de los SDK de Amazon. Para obtener más información sobre el uso de S3 Glacier con la AWS CLI, consulte la Referencia de la AWS CLI para S3 Glacier. Para instalar la AWS CLI, visite AWS Command Line Interface
Búsqueda de un ID de archivo en Amazon S3 Glacier
Puede obtener el ID de archivo descargando el inventario correspondiente al almacén que contiene el archivo. Para obtener más información acerca de cómo descargar un inventario de almacén, consulte Descarga de un inventario de almacén en Amazon S3 Glacier.
Descarga de un archivo en Amazon S3 Glacier
La descarga de un archivo es asíncrona. En primer lugar, debe iniciar un trabajo para descargar un archivo específico. Después de recibir la solicitud de trabajo, S3 Glacier prepara el archivo para descargarlo. Después de que se complete el trabajo, podrá descargar los datos de archivo. Debido a la naturaleza asíncrona del trabajo, puede solicitar a S3 Glacier que envíe una notificación a un tema de Amazon Simple Notification Service (Amazon SNS) cuando se complete el trabajo. Puede especificar un tema de SNS para cada solicitud de trabajo individual o configurar el almacén para enviar una notificación cuando se producen determinados eventos. Para obtener más información sobre cómo descargar un archivo, consulte Descarga de un archivo en S3 Glacier.
Eliminación de un archivo en Amazon S3 Glacier
S3 Glacier ofrece una llamada a la API que puede utilizar para eliminar los archivos de uno en uno. Para obtener más información, consulte Eliminación de un archivo en Amazon S3 Glacier.
Actualización de un archivo en S3 Glacier
Después de cargar un archivo, no puede actualizar su contenido ni su descripción. La única forma en que puede actualizar el contenido del archivo o su descripción es eliminándolo y cargando otro archivo. Tenga en cuenta que cada vez que carga un archivo, S3 Glacier le devuelve un ID de archivo único.
Mantenimiento de metadatos de archivos en el cliente
A excepción de la descripción opcional del archivo, S3 Glacier no admite metadatos adicionales para los archivos. Cuando carga un archivo, S3 Glacier asigna un ID, una secuencia de caracteres opaca de la que no se puede deducir nada significativo sobre el archivo. Podría realizar el mantenimiento de los metadatos sobre los archivos en el cliente. Los metadatos pueden incluir el nombre de archivo y otra información significativa sobre él.
nota
Si es cliente de Amazon Simple Storage Service (Amazon S3), sabe que al cargar un objeto en un bucket puede asignar una clave al objeto, como MyDocument.txt
o SomePhoto.jpg
. En S3 Glacier, no puede asignar una clave de objeto a los archivos que cargue.
Si realiza el mantenimiento de los metadatos de archivo en el cliente, tenga en cuenta que S3 Glacier mantiene un inventario de almacén que incluye los ID de archivo y las descripciones que ha proporcionado durante la carga del archivo. En ocasiones puede descargar el inventario de almacén para conciliar los problemas en la base de datos en el cliente que mantiene para los metadatos de archivo. No obstante, S3 Glacier genera un inventario de almacén aproximadamente una vez al día. Al solicitar un inventario de almacén, S3 Glacier devuelve el último inventario que ha preparado, una instantánea puntual.