Cargas multiparte de la API de XML

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

Descripción general

Una carga multiparte de la API de XML te permite subir datos en varias partes y, luego, ensamblarlas 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 necesario para subir los datos en su totalidad.

  • Si falla una de las operaciones de carga, solo tienes que 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 de antemano, puedes usar cargas de varias partes de la API de XML para transferencias de transmisión o para comprimir datos sobre la marcha durante la carga.

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

  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 existen límites para 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 consideran en el uso de almacenamiento mensual.

Consideraciones

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

  • Las condiciones previas no son compatibles con las solicitudes.
  • Los hashes MD5 no existen para los objetos subidos mediante este método.
  • Este método de carga no es compatible con Google Cloud Console, gsutil ni con las bibliotecas cliente de Cloud Storage.

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

  • Si bien puedes iniciar partes de la carga y la carga, la solicitud para completar la carga fallará si reemplazara un objeto que tiene una conservación o un período de retención no completado en un elemento.

  • 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 carga se completa, pero la parte no se usa en la solicitud de finalización.
    • Otra parte reemplaza la parte que se subió.
    • La carga multiparte general se anula.

    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?