Esta página es solo para los clientes actuales del servicio Amazon Glacier que utilizan Vaults y la API REST original de 2012.
Si busca soluciones de almacenamiento de archivos, le recomendamos 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 bóveda) 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 propio APIs 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 se requiere ninguna migración. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las clases de almacenamiento Amazon S3 Glacier
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 Glacier (Amazon Glacier) crea un recurso de carga de varias partes 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 necesita saber el tamaño del archivo al iniciar una carga de varias partes, ya que Amazon Glacier no requiere que especifique el tamaño total del archivo.
Tras completar la carga multiparte, Amazon Glacier elimina el recurso de carga multiparte al que hace referencia el ID. Amazon Glacier también eliminará el recurso de carga multiparte si cancela la carga multiparte o puede eliminarlo si no hay actividad durante un período 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 AccountId valor es el Cuenta de AWS ID de la cuenta propietaria del almacén. Puede especificar un Cuenta de AWS ID o, si lo desea, un solo - '' (guión), en cuyo caso Amazon Glacier utilizará el Cuenta de AWS ID asociado a las credenciales utilizadas 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 de varias partes identificado por un ID y devuelve la ruta de URI relativa del ID de carga de varias partes.
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
|
La ruta 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 sobre las excepciones y los mensajes de error de Amazon Glacier, consulteRespuestas 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 añade al multipart-uploads subrecurso 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
