Esta página es solo para los clientes actuales del servicio S3 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 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
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. Como respuesta, Amazon S3 Glacier (S3 Glacier) devuelve el ID de archivo en el encabezado x-amz-archive-id 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 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. S3 Glacier devuelve la descripción del archivo cuando recupera el archivo u obtiene el inventario de almacenes. S3 Glacier no interpreta la descripción en modo alguno. 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 opcional del archivo, S3 Glacier no admite metadatos adicionales 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 S3 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, 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 único - '' (guión), en cuyo caso Amazon S3 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 S3 Glacier calcula otra suma de comprobación de la carga, 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, S3 Glacier almacena de forma duradera el archivo y devuelve una ruta de URI al ID de 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 S3 Glacier. 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 S3 Glacier, consulte Respuestas 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 respuesta correcta a continuación tiene un encabezado Location donde puede obtener el ID que S3 Glacier ha asignado 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
