CreateMultipartUpload

Documentación: CreateMultipartUpload

Descripción

La operación CreateMultipartUpload inicia un cargamento de varias partes. Un cargamento de varias partes permite cargar un solo objeto como un conjunto de partes más pequeñas. Esta característica permite:

  • Subir objetos grandes en partes.

  • Pausar y reanudar la carga de un objeto.

  • Recuperarse de fallos de red.

Una vez que todas las partes han sido subidas, se debe llamar a la operación CompleteMultipartUpload para ensamblar el objeto a partir de las partes.

Solicitud

Método: POST

URI:

  • Estilo virtual-host: https://{bucket-name}.s3.latam-scl-x.datageneral.cl/{object-key}?uploads

  • Estilo path: https://s3.latam-scl-x.datageneral.cl/{bucket-name}/{object-key}?uploads

Encabezados:

  • Host: Requerido. Especifica el nombre del bucket (para virtual-host) o el host del servicio (para path-style).

  • Date: Requerido. Fecha y hora de la solicitud.

  • Authorization: Requerido. Contiene la firma de la solicitud para la autenticación.

  • Content-Type: Opcional. El tipo de contenido del objeto.

  • x-amz-acl: Opcional. Define el Access Control List (ACL) para el objeto.

  • x-amz-storage-class: Opcional. La clase de almacenamiento para el objeto.

  • x-amz-meta-*: Opcional. Metadatos definidos por el usuario.

  • x-amz-server-side-encryption: Opcional. Tipo de encriptación a usar.

Cuerpo de la solicitud:**

  • Opcional. Puede contener una configuración XML para especificar propiedades del cargamento multipart.

Respuesta

Códigos de estado:

  • 200 OK: El cargamento de varias partes se inició correctamente.

  • 400 Bad Request: La solicitud no se pudo procesar debido a un error del cliente.

  • 403 Forbidden: El cliente no tiene permiso para iniciar el cargamento de varias partes.

  • 404 Not Found: El bucket no existe.

  • Otros códigos de error: Pueden aplicar códigos de error específicos del servicio S3.

Encabezados de la respuesta:

  • Date: Fecha y hora de la respuesta.

  • x-amz-request-id: Un identificador único para la solicitud.

  • x-amz-id-2: Un identificador único extendido para la solicitud.

  • Server: Información sobre el servidor que procesó la solicitud.

Cuerpo de la respuesta:

Contiene un documento XML con el ID del cargamento multipart.

<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
  <Bucket>nombre-del-bucket</Bucket>
  <Key>nombre-del-objeto</Key>
  <UploadId>identificador-único-del-cargamento</UploadId>
</InitiateMultipartUploadResult>

Ejemplos

Ejemplo de solicitud (sin cuerpo):

POST /objeto1.txt?uploads HTTP/1.1
Host: my-bucket.s3.latam-scl-x.datageneral.cl
Date: Fri, 30 Jul 2024 23:00:00 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:QWxhZGVpbjEgXA==

Ejemplo de respuesta:

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2024 23:00:01 GMT
Content-Type: application/xml
x-amz-request-id: 65423A7B884B82F1
Server: MyS3Server

<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
  <Bucket>my-bucket</Bucket>
  <Key>objeto1.txt</Key>
  <UploadId>9876543210abcdefghijklmnopqrstuvwxyz</UploadId>
</InitiateMultipartUploadResult>

Ejemplo de solicitud (con metadatos):

POST /imagen.jpg?uploads HTTP/1.1
Host: my-bucket.s3.latam-scl-x.datageneral.cl
Date: Fri, 30 Jul 2024 23:15:00 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:QWxhZGVpbjEgXA==
x-amz-meta-nombre: "Imagen de prueba"
x-amz-meta-autor: "Usuario123"

Ejemplo de respuesta:

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2024 23:15:01 GMT
Content-Type: application/xml
x-amz-request-id: 98765QWERTYUIOP
Server: MyS3Server

<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
  <Bucket>my-bucket</Bucket>
  <Key>imagen.jpg</Key>
  <UploadId>zyxwvutsrqponmlkjihgfedcba0987654321</UploadId>
</InitiateMultipartUploadResult>
AnteriorPutObjectSiguienteUploadPart

Última actualización