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.
Carga de archivo (POST archivo)
Descripción
Esta operación agrega un archivo a un almacén. Para que una carga se realice correctamente, los datos persisten de forma duradera. En respuesta, Amazon Glacier (Amazon Glacier) devuelve el ID del archivo que aparece en el x-amz-archive-id encabezado de la respuesta. Debe guardar el ID de archivo devuelto para poder obtener acceso al archivo posteriormente.
Debe proporcionar un hash de SHA256 árbol de los datos que va a cargar. Para obtener información sobre cómo calcular un hash de SHA256 árbol, consulteCálculo de sumas de comprobación.
nota
El hash de SHA256 árbol solo es necesario para la acción de cargar un archivo (archivo POST) cuando se utiliza la API. No es obligatorio cuando se utiliza el AWS CLI.
Al cargar un archivo, si lo desea, puede especificar una descripción de archivo de un máximo de 1024 caracteres ASCII imprimibles. Amazon Glacier devuelve la descripción del archivo al recuperar el archivo o al obtener el inventario del almacén. Amazon Glacier no interpreta la descripción de ninguna manera. Una descripción de archivo no tiene por qué ser única. No puede utilizar la descripción para recuperar u ordenar la lista de archivos.
A excepción de la descripción del archivo opcional, Amazon Glacier no admite ningún metadato adicional para los archivos. El ID de archivo es una secuencia de caracteres opaca de la que no se puede deducir nada significativo sobre el archivo. Por lo tanto, podría realizar el mantenimiento de los metadatos sobre los archivos en el cliente. Para obtener más información, consulte Trabajar con archivos en Amazon Glacier.
Los archivos son inmutables. Después de cargar un archivo, no puede editar el archivo ni su descripción.
Solicitudes
Para cargar un archivo, utilice el método HTTP POST y establezca el ámbito de la solicitud en el subrecurso archives del almacén en el que desea guardar el archivo. La solicitud debe incluir el tamaño de la carga útil del archivo y la suma de comprobación (hash SHA256 del árbol) y, si lo desea, puede incluir una descripción del archivo.
Sintaxis
POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-Length:Length<Request body.>
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 aplicación de la operación no utiliza 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 |
|---|---|---|
Content-Length
|
El tamaño del objeto, en bytes. Para obtener más información, visite http://www.w3. org/Protocols/rfc2616/rfc2616-sec14.html #sec14 .13. Tipo: Number Valor predeterminado: none Restricciones: ninguna |
Sí |
x-amz-archive-description
|
La descripción opcional del archivo que está cargando. Puede ser una descripción en lenguaje natural o un identificador que decida asignar. La descripción no tiene que ser única en los archivos. Cuando recupere un inventario de almacén (consulte Inicialización de trabajos (POST trabajos)), incluirá esta descripción en cada uno de los archivos que devuelva la respuesta. Tipo: cadena Valor predeterminado: None Restricciones: la descripción debe tener 1024 caracteres 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 |
x-amz-content-sha256
|
La SHA256 suma de comprobación (un hash lineal) de la carga útil. No es el mismo valor que se especifica en el encabezado Tipo: cadena Valor predeterminado: None Restricciones: ninguna |
Sí |
x-amz-sha256-tree-hash
|
La suma de comprobación calculada por el usuario (hash de SHA256 árbol) de la carga útil. Para obtener información sobre cómo calcular el hash del SHA256 árbol, consulte. Cálculo de sumas de comprobación Si Amazon Glacier calcula una suma de comprobación diferente de la carga útil, rechazará la solicitud. Tipo: cadena Valor predeterminado: None Restricciones: ninguna |
Sí |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene los datos que se van a cargar.
Respuestas
En respuesta, Amazon Glacier almacena el archivo de forma duradera y devuelve una ruta URI al ID del archivo.
Sintaxis
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location x-amz-archive-id: ArchiveId
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 del URI relativo del recurso de archivo agregado recientemente. Tipo: cadena |
x-amz-archive-id
|
El ID del archivo. Este valor también forma parte del encabezado Tipo: cadena |
x-amz-sha256-tree-hash |
La suma de comprobación del archivo calculada por Amazon Glacier. 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.
Ejemplos
Solicitud de ejemplo
En el siguiente ejemplo se muestra una solicitud para cargar un archivo.
POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace <Request body (2097152 bytes).>
Respuesta de ejemplo
La siguiente respuesta correcta tiene un Location encabezado en el que puede obtener el ID que Amazon Glacier asignó al archivo.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
Secciones relacionadas
