Inicio de la carga multiparte (POST cargas-multiparte) - Amazon S3 Glacier
DescripciónSolicitudesRespuestasEjemplo Secciones relacionadas

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.

Inicio de la carga multiparte (POST cargas-multiparte)

Descripción

Esta operación inicia una carga multiparte (consulte Carga de archivos grandes por partes (carga multiparte)). Amazon S3 Glacier (S3 Glacier) crea un recurso de carga multiparte y devuelve su ID en la respuesta. Puede utilizar este ID de carga en las operaciones de carga multiparte que realice posteriormente.

Cuando inicie una carga multiparte, debe especificar el tamaño de la parte en número de bytes. El tamaño de la parte debe ser de un mebibyte (MiB) (1024 kibibytes [KiB]) multiplicado por una potencia de 2; por ejemplo, 1 048 576 (1 MiB), 2 097 152 (2 MiB), 4 194 304 (4 MiB), 8 388 608 (8 MiB) y así sucesivamente. El tamaño de parte mínimo permitido es de 1 MiB y el máximo es de 4 gibibytes (GiB).

Todas las partes que cargue con este ID de carga, salvo la última, deben tener el mismo tamaño. La última puede tener el mismo tamaño o ser más pequeña. Por ejemplo, supongamos que quiere cargar un archivo de 16,2 MiB. Si inicia la carga multiparte con un tamaño de parte de 4 MiB, cargará cuatro partes de 4 MiB cada una y otra parte de 0,2 MiB.

nota

No es necesario conocer el tamaño del archivo al iniciar una carga multiparte, ya que S3 Glacier no requiere que se especifique el tamaño total del archivo.

Una vez que se completa la carga multiparte, S3 Glacier elimina el recurso de carga multiparte al que hace referencia el ID. S3 Glacier también eliminará este recurso si cancela la carga multiparte o podría eliminarlo si no hay actividad durante un periodo de 24 horas. Es posible que el ID siguiera disponible después de 24 horas, pero no es conveniente que las aplicaciones esperen que sea así.

Solicitudes

Para iniciar una carga multiparte, envíe una solicitud HTTP POST al URI del subrecurso multipart-uploads del almacén en el que desea guardar el archivo. La solicitud debe incluir el tamaño de la parte y, de manera opcional, una descripción del archivo.

Sintaxis

POST /AccountId/vaults/VaultName/multipart-uploads 
Host: glacier.us-west-2.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01
x-amz-archive-description: ArchiveDescription
x-amz-part-size: PartSize

nota

El valor AccountId es el ID de la Cuenta de AWS propietaria del almacén. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “-” (guion), en cuyo caso, Amazon S3 Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

Parámetros de solicitud

Esta operación no usa parámetros de solicitud.

Encabezados de solicitud

Esta operación utiliza los siguientes encabezados de solicitud, además de los encabezados de solicitud comunes a todas las operaciones. Para obtener más información acerca de los encabezados de solicitudes comunes, consulte Encabezados de solicitudes comunes.

Nombre Descripción Obligatorio
x-amz-part-size

Tamaño en bytes de cada parte, excepto la última. La última parte puede ser más pequeña.

Tipo: String

Valor predeterminado: None

Restricciones: el tamaño de la parte debe ser de un mebibyte (MiB) (1024 KiB) multiplicado por una potencia de 2; por ejemplo, 1 048 576 (1 MiB), 2 097 152 (2 MiB), 4 194 304 (4 MiB), 8 388 608 (8 MiB) y así sucesivamente. El tamaño de parte mínimo permitido es de 1 MiB y el máximo es de 4 GiB (4 096 MiB).

 Sí
x-amz-archive-description

Descripción del archivo que está cargando por partes. Puede ser una descripción en lenguaje natural o un identificador único que decida asignar. Cuando recupere un inventario de almacén (consulte Iniciar trabajo (POSTtrabajos) ), el inventario incluirá esta descripción en cada uno de los archivos que devuelva la respuesta. Los espacios iniciales de las descripciones de archivo se quitan.

Tipo: String

Valor predeterminado: None

Restricciones: la descripción debe tener 1024 bytes o menos. Los caracteres permitidos son caracteres ASCII de 7 bits sin códigos de control; en particular, valores ASCII de 32 a 126 en decimal o de 0x20 a 0x7E en hexadecimal.

 No

Cuerpo de la solicitud

Esta operación no tiene un cuerpo de la solicitud.

Respuestas

En la respuesta, S3 Glacier crea un recurso de carga multiparte identificado por un ID y devuelve la ruta de URI relativa del ID de carga multiparte.

Sintaxis

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-multipart-upload-id: multiPartUploadId

Encabezados de respuesta

Una respuesta correcta incluye los siguientes encabezados de respuesta, además de los encabezados de respuesta comunes a todas las operaciones. Para obtener más información acerca de los encabezados de respuesta comunes, consulte Encabezados de respuesta comunes.

Nombre Descripción
Location

Ruta de URI relativa del ID de carga multiparte creado por S3 Glacier. Puede utilizar esta ruta de URI para establecer el ámbito de las solicitudes cuyas partes se van a cargar y para completar la carga multiparte.

Tipo: String
x-amz-multipart-upload-id

ID de la carga multiparte. Este valor también forma parte del encabezado Location.

Tipo: String

Cuerpo de respuesta

Esta operación no devuelve ningún cuerpo de respuesta.

Errores

Para obtener información acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas de error.

Ejemplo

Solicitud de ejemplo

En el siguiente ejemplo, se inicia una carga multiparte enviando una solicitud HTTP POST al URI del subrecurso multipart-uploads de un almacén llamado examplevault. La solicitud incluye encabezados para especificar un tamaño de parte de 4 MiB (4 194 304 bytes) y la descripción opcional del archivo.

POST /-/vaults/examplevault/multipart-uploads 
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-archive-description: MyArchive-101
x-amz-part-size: 4194304
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Respuesta de ejemplo

S3 Glacier crea un recurso de carga multiparte y lo agrega al subrecurso multipart-uploads del almacén. El encabezado Location de la respuesta contiene la ruta de URI relativa al ID de carga multiparte. 

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE

Para obtener más información sobre la carga de partes individuales, consulte Carga de partes (PUT uploadID).