Esta página es solo para los clientes actuales del servicio Amazon Glacier que utilizan Vaults y la API de REST original de 2012.
Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de Amazon 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 las clases de almacenamiento de Amazon Glacier
Amazon Glacier (servicio original independiente basado en almacenes) ya no aceptará nuevos clientes a partir del 15 de diciembre de 2025, sin que ello afecte a los clientes actuales. Amazon Glacier es un servicio independiente con sus propias API que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las clases de almacenamiento Amazon S3 Glacier
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 Glacier (Amazon 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 Amazon Glacier no requiere que se especifique el tamaño total del archivo.
Una vez que se completa la carga multiparte, Amazon Glacier elimina el recurso de carga multiparte al que hace referencia el ID. Amazon 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:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01 x-amz-archive-description:ArchiveDescriptionx-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 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 la 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: cadena 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 Inicialización de trabajos (POST trabajos) ), 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: cadena 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, Amazon 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 Amazon 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: cadena |
x-amz-multipart-upload-id
|
ID de la carga multiparte. Este valor también forma parte del encabezado Tipo: cadena |
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 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
Amazon 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).
Secciones relacionadas
