Carga de archivos grandes por partes (carga multiparte) - Amazon S3 Glacier

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.

Carga de archivos grandes por partes (carga multiparte)

Proceso Multipart Upload

Tal y como se describe en Carga de un archivo en Amazon S3 Glacier, recomendamos a nuestros clientes de Amazon S3 Glacier (S3 Glacier) que utilicen la carga multiparte para cargar archivos superiores a 100 mebibytes (MiB).

  1. Initiate Multipart Upload

    Cuando envía una solicitud para iniciar una carga multiparte, S3 Glacier devuelve un ID de carga multiparte, que es un identificador único de esta. Cualquier operación de carga multiparte que se ejecute posteriormente necesitará este ID, Este ID se mantendrá en vigor al menos 24 horas después de que S3 Glacier haya finalizado el trabajo.

    En la solicitud para iniciar una carga multiparte, especifique el tamaño de la parte en número de bytes. Todas las partes que se carguen, salvo la última, deben tener este tamaño.

    nota

    Cuando se utiliza las cargas multiparte, no es necesario conocer el tamaño total del archivo. Esto significa que puede utilizar cargas multiparte en los casos en que no sepa el tamaño del archivo cuando comience a cargar el archivo. Cuando inicie una carga multiparte, lo único que debe decidir es el tamaño de la parte.

    En la solicitud Initiate Multipart Upload, también puede proporcionar una descripción opcional del archivo.

  2. Carga de las partes

    En cada solicitud de carga, debe incluir el ID de la carga multiparte que obtuvo en el paso 1. En la solicitud, también debe especificar el intervalo de contenido en bytes, lo que identificará la posición de la parte en el archivo final. S3 Glacier utilizará la información del intervalo de contenido más adelante para montar el archivo en el orden correcto. Como usted proporciona el intervalo de contenido con cada parte que carga, esto determina la posición de la parte en el conjunto final del archivo y, por tanto, puede cargar las partes en cualquier orden. También puede cargar las partes en paralelo. Si carga una parte nueva con el mismo intervalo de contenido que una parte que cargó previamente, la parte existente se sobrescribirá.

  3. Finalización (o detención) de una carga multiparte

    Después de cargar todas las partes del archivo, puede utilizar la operación de finalización. Una vez más, debe especificar el ID de carga en la solicitud. S3 Glacier crea un archivo mediante la concatenación de las partes en orden ascendente en función del intervalo de contenido proporcionado. La respuesta de S3 Glacier a una solicitud Complete Multipart Upload incluye el ID del archivo que se acaba de crear. Si ha proporcionado una descripción opcional del archivo en la solicitud Initiate Multipart Upload, S3 Glacier asociará esta descripción al archivo montado. Una vez que una carga multiparte se ha realizado correctamente, no se puede consultar su ID. Esto significa que no puede obtener acceso a las partes asociadas con el ID de carga multiparte.

    Si detiene una carga multiparte, no puede cargar ninguna otra parte con el ID de esa carga. Todo el almacenamiento utilizado por las partes asociadas a la carga multiparte detenida quedará libre. Si la carga de alguna de las partes estuviera en curso, todavía se puede ejecutar correctamente o producir un error una vez detenida.

Otras operaciones de carga multiparte

Amazon S3 Glacier (S3 Glacier) ofrece las siguientes llamadas adicionales a la API de carga multiparte.

  • List Parts: con esta operación, puede enumerar las partes de una determinada carga multiparte. Esta operación devuelve información sobre las partes cargadas en una carga multiparte. En cada solicitud de enumeración de las partes, S3 Glacier devuelve información de hasta 1000 partes. Si hay más partes para mostrar en la carga multiparte, el resultado se pagina y se devuelve un marcador en la respuesta que señala el punto en el que continúa la lista. Para recuperar las partes siguientes, debe enviar otras solicitudes. Tenga en cuenta que la lista de partes que se devuelve no incluye las partes con carga incompleta.

  • List Multipart Uploads: con esta operación, puede obtener una lista de las cargas multiparte en curso. Una carga multiparte en curso es una carga iniciada, pero que aún no se ha completado ni parado. En cada solicitud de enumeración de las cargas multiparte, S3 Glacier devuelve un máximo de 1000 cargas multiparte. Si hay más cargas multiparte para mostrar, el resultado se pagina y se devuelve un marcador en la respuesta que señala el punto en el que continúa la lista. Para recuperar las cargas multiparte restantes, debe enviar otras solicitudes.

Información relevante

En la siguiente tabla se proporcionan las especificaciones principales de la carga multiparte.

Elemento Especificación
Tamaño máximo del archivo 10 000 x 4 gibibytes (GiB)
Cantidad máxima de partes por cada carga 10 000
Tamaño de parte

1 MiB a 4 GiB, la última parte puede ser < 1 MiB. El tamaño debe especificarse en bytes.

El tamaño de la parte debe ser de un mebibyte (1024 kibibytes [KiB]) multiplicado por una potencia de 2. Por ejemplo, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB).

Cantidad máxima de partes devueltas para una solicitud de lista de partes 1 000
Cantidad máxima de cargas multipartes devueltas en una solicitud de lista de cargas multipartes 1 000