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 a un bucket de Lightsail con carga multiparte

Con la carga multiparte, puede cargar un solo archivo al bucket como un conjunto de partes. Cada parte es una parte contigua de los datos del archivo. Puede cargar estas partes del archivo de forma independiente y en cualquier orden. Si la transmisión de cualquier parte falla, puede retransmitir esta parte sin que las demás partes se vean afectadas. Después de cargar todas las partes del archivo, Amazon S3 las combina y crea el objeto en su bucket de Amazon Lightsail. Por lo general, cuando el tamaño del objeto alcanza los 100 MB, deberá usar las cargas multipartes en lugar de cargar el objeto en una única operación. Para obtener más información sobre los buckets, consulte Almacenamiento de objetos.

El uso de la carga multiparte proporciona las siguientes ventajas:

Le recomendamos que use la carga multiparte de las siguientes maneras:

Contenido

Proceso de carga multiparte

La carga multiparte es un proceso de tres pasos que utiliza acciones de Amazon S3 para cargar archivos en un bucket de Lightsail:

Cuando se completa la solicitud de carga multiparte, Amazon Simple Storage Service construye el objeto a partir de las partes cargadas. Luego puede acceder al objeto de la misma manera que accedería a cualquier otro objeto en su bucket.

Puede mostrar todas las cargas multipartes en curso u obtener una lista de las partes que ha cargado en una carga multiparte específica. En esta sección, se explicarán cada una de estas operaciones.

Inicio de la carga multiparte

Al enviar una solicitud para iniciar una carga multiparte, Amazon Simple Storage Service devuelve una respuesta con un ID de carga. Se trata de un identificador único para la carga multiparte. Debe incluir el ID de carga siempre que cargue partes, muestre partes, complete una carga o pare una carga. Si desea proporcionar metadatos que describen el objeto que está cargando, debe proporcionarlos en la solicitud para iniciar la carga multiparte.

Carga de partes

Al cargar una parte, además del ID de carga, debe especificar un número de parte. Puede seleccionar cualquier número de parte comprendido entre 1 y 10 000. Un número de parte identifica exclusivamente una parte y su posición en el objeto que se está cargando. El número de parte que elija no tiene que ser necesariamente una secuencia consecutiva (por ejemplo: puede ser 1, 5 y 14). Si carga una parte nueva con el mismo número que una parte ya cargada, se sobrescribirá la parte existente.

Siempre que cargue una parte, Amazon Simple Storage Service devolverá un encabezado ETag en la respuesta. Para cada carga de parte, debe anotar el número de parte y el valor de ETag. Debe incluir estos valores en la solicitud posterior para completar la carga multiparte.

Finalización de la carga multiparte

Al completar una carga multiparte, Amazon Simple Storage Service crea un objeto mediante la concatenación de las partes en orden ascendente según el número de parte. Si se proporcionaron los metadatos de algún objeto en la solicitud de inicio de carga multiparte, Amazon Simple Storage Service asocia estos metadatos al objeto. Después de una solicitud de finalización realizada correctamente, las partes ya no existirán.

La solicitud de carga multiparte completa debe incluir el ID de carga y una lista de los números de parte y valores correspondientes de ETag. La respuesta de Amazon Simple Storage Service incluye una ETag que identifica de forma exclusiva los datos de objetos combinados. Esta ETag no es necesariamente un hash de MD5 de los datos del objeto.

Puede optar por parar la carga multiparte. Después de parar una carga multiparte, no puede volver a cargar ninguna parte con ese ID de carga. A continuación, se libera todo el almacenamiento de las partes de la carga multiparte cancelada. Si la carga de alguna de las partes estuviera en curso, todavía se puede ejecutar correctamente o producir un error una vez detenida. Para liberar todo el espacio de almacenamiento consumido por las partes, debe parar una carga multiparte solo después de haber completado las cargas de todas las partes.

Listas de cargas multiparte

Puede enumerar las partes de una carga multiparte específica o todas las cargas multipartes en curso. La operación de lista de partes devuelve la información de las partes que ha cargado para una carga multiparte específica. Para cada solicitud de lista de partes, Amazon Simple Storage Service devuelve la información de las partes para la carga multiparte específica, hasta un máximo de 1000 partes. Si hay más de 1 000 partes en la carga multiparte, debe enviar una serie de solicitudes de lista de partes para recuperar todas las partes. Tenga en cuenta que la lista de partes que se devuelve no incluye las partes en proceso de carga. Con la operación de enumeración de cargas multiparte, 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. Cada solicitud devuelve 1 000 cargas multipartes como máximo. Si hay más de 1 000 cargas multiparte en curso, debe enviar otras solicitudes para recuperar las cargas multiparte restantes. Solamente utilice la lista devuelta para verificación. No utilice el resultado de esta lista al enviar una solicitud de finalización de carga multiparte. Como alternativa, mantenga su propia lista de números de parte que especificó al cargar las partes y los valores correspondientes de ETag que devuelve Amazon Simple Storage Service.

Operaciones de carga multiparte simultáneas

En un entorno de desarrollo distribuido, es posible que la aplicación inicie varias actualizaciones en el mismo objeto simultáneamente. La aplicación puede iniciar varias cargas multipartes con la misma clave de objeto. Para cada una de estas cargas, la aplicación puede cargar las partes y enviar una solicitud de carga completa a Amazon Simple Storage Service para crear el objeto. Cuando los buckets tienen el control de versiones habilitado, siempre se creará una nueva versión cuando se complete una carga multiparte. En el caso de los buckets que no tienen el control de versiones habilitado, es posible que tenga prioridad otra solicitud, como las solicitudes que se reciben después de iniciarse una carga multiparte y antes de que se complete.

Retención de cargas multiparte

Todas las partes cargadas de una carga multiparte se almacenan en su bucket. Consumirán el espacio de almacenamiento de su depósito hasta que complete la carga, detenga la carga o se agote el tiempo de espera de la carga. Una carga multiparte agota el tiempo de espera y la carga multiparte se elimina 24 horas después de su creación. Cuando detiene una carga multiparte o se agota el tiempo de espera, se eliminan todas las partes cargadas y se libera el espacio de almacenamiento que utilizaban en el bucket.

Límites de carga multiparte de Amazon Simple Storage Service

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

División del archivo para cargarlo

Utilice el comando split en el sistema operativo Linux o Unix para dividir un archivo en varias partes que luego cargará en su bucket. Hay aplicaciones gratuitas similares que puede usar en el sistema operativo Windows para dividir un archivo. Después de dividir el archivo en varias partes, continúe con la sección Inicio de una carga multiparte de esta guía.

Inicio de una carga multiparte con la AWS CLI

Complete el siguiente procedimiento para iniciar una carga multiparte mediante la AWS Command Line Interface (AWS CLI). Para ello, utilice el comando create-multipart-upload. Para obtener más información, consulte create-multipart-upload en la Referencia de comandos de la AWS CLI.

Carga de una parte con la AWS CLI

Complete el siguiente procedimiento para cargar una parte de una carga multiparte mediante la AWS Command Line Interface (AWS CLI). Para ello, utilice el comando upload-part. Para obtener más información, consulte upload-part en la Referencia de comandos de la AWS CLI.

Enumeración de partes de una carga multiparte con AWS CLI

Complete el siguiente procedimiento para enumerar partes de una carga multiparte mediante la AWS Command Line Interface (AWS CLI). Para ello, utilice el comando list-parts. Para obtener más información, consulte list-parts en la Referencia de comandos de la AWS CLI.

Complete este procedimiento para obtener los valores ETag para todas las partes cargadas en una carga multiparte. Necesitará estos valores para completar la carga multiparte más adelante en esta guía. Sin embargo, si registró todos los valores ETag de la respuesta de las cargas de partes, puede omitir este procedimiento y continuar con la sección Creación de un archivo .json de carga multiparte de esta guía.

Creación de un archivo .json de carga multiparte

Complete el siguiente procedimiento para crear un archivo .json de carga multiparte que defina todas las partes que ha cargado y sus valores ETag. Esto es necesario más adelante en esta guía para completar la carga multiparte.

Finalización de una carga multiparte con AWS CLI

Complete el siguiente procedimiento para completar una carga multiparte mediante la AWS Command Line Interface (AWS CLI). Para ello, utilice el comando complete-multipart-upload. Para obtener más información, consulte complete-multipart-upload en la Referencia de comandos de la AWS CLI.

Enumeración de cargas multiparte para un bucket mediante AWS CLI

Complete el siguiente procedimiento para enumerar todas las cargas multiparte de un bucket mediante la AWS Command Line Interface (AWS CLI). Para ello, utilice el comando list-multipart-uploads. Para obtener más información, consulte list-multipart-uploads en la Referencia de comandos de la AWS CLI.

Detención de una carga multiparte con AWS CLI

Complete el siguiente procedimiento para detener una carga multiparte mediante la AWS Command Line Interface (AWS CLI). Haga esto si inició una carga multiparte pero ya no desea continuar. Para ello, utilice el comando abort-multipart-upload. Para obtener más información, consulte abort-multipart-upload en la Referencia de comandos de la AWS CLI.