Cargas multiparte de la API de XML

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

En esta página, se analizan las cargas multiparte de la API de XML en Cloud Storage. Este método sube archivos en partes y, luego, los ensambla en un solo objeto mediante una solicitud final. Las cargas multiparte de la API de XML son compatibles con las cargas multipartes de Amazon S3.

Descripción general

Una carga multiparte de la API de XML te permite subir datos en varias partes y, luego, ensamblarlos en un objeto final. Este comportamiento tiene varias ventajas, en especial para archivos grandes:

  • Puedes subir partes de forma simultánea, lo que reduce el tiempo que lleva subir los datos en su totalidad.

  • Si una de las operaciones de carga falla, solo debes volver a subir una parte del objeto general, en lugar de reiniciarlo desde el principio.

  • Dado que el tamaño total del archivo no se especifica con anticipación, puedes usar las cargas multiparte de la API de XML para transferencias de transmisión o a fin de comprimir datos sobre la marcha durante la carga.

Una carga multiparte de la API de XML tiene tres pasos necesarios:

  1. Inicia la carga con una solicitud POST, que incluye especificar cualquier metadato que tenga el objeto completado. La respuesta muestra un UploadId que usarás en todas las solicitudes posteriores asociadas a la carga.

  2. Sube los datos con una o más solicitudes PUT. Ten en cuenta que hay límites en la cantidad de partes y sus tamaños.

  3. Completa la carga con una solicitud POST. Esta solicitud reemplaza cualquier objeto existente en el bucket con el mismo nombre.

No hay límite para la duración de una carga multiparte y sus partes subidas puede permanecer sin terminar o inactiva en un bucket, pero ten en cuenta que las partes subidas de forma correcta se toman en cuenta para el uso de almacenamiento mensual. Puedes evitar la acumulación de cargas multiparte abandonadas mediante la Administración del ciclo de vida de los objetos para quitar de forma automática las cargas multiparte cuando alcancen una antigüedad específica.

Consideraciones

Las siguientes limitaciones se aplican al uso de las cargas multiparte de la API de XML:

  • Un objeto que se sube con este método no se puede copiar ni reescribir, a menos que redactes el objeto antes de copiarlo o volver a escribirlo.
  • Las condiciones previas no son compatibles con las solicitudes.
  • Los hashes de MD5 no existen para los objetos subidos que se usan con este método.
  • Este método de carga no es compatible con Google Cloud Console, gsutil ni las bibliotecas cliente de Cloud Storage.
  • La replicación turbo no se aplica a los objetos subidos mediante este método.

Ten en cuenta lo siguiente cuando trabajes con cargas multiparte de la API de XML:

  • Si bien puedes iniciar partes de carga y carga, la solicitud para completar la carga fallará si reemplazaría un objeto que tiene una conservación en ella o en una falta de cumplimiento período de retención.

  • Puedes enumerar las cargas en curso en un bucket, pero solo una carga completa aparece en la lista normal de objetos en el bucket.

  • Las partes subidas están sujetas a cargos de eliminación temprana si usan una clase de almacenamiento aplicable y se produce alguna de las siguientes situaciones antes de que la parte alcance la duración de almacenamiento mínima:

    La duración del almacenamiento de cada parte de una carga multiparte comienza en el momento en que se completa la carga de la parte.

¿Qué sigue?