Carga de partes (PUT uploadID) - Amazon Glacier
DescripciónSolicitudesRespuestasEjemploSecciones relacionadas

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, que ofrecen una experiencia de cliente superior con S3 basada en cubos APIs, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra Guía de AWS soluciones para transferir datos de los almacenes de Amazon Glacier a las clases de almacenamiento de 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 partes (PUT uploadID)

Descripción

Esta operación de carga multiparte carga una parte de un archivo. Las partes de un archivo se pueden cargar en cualquier orden, ya que, en la solicitud Upload Part, se especifica el intervalo de bytes del archivo montado que se va a cargar en esa parte. Las partes también pueden cargarse en paralelo. En una carga multiparte, se pueden cargar hasta 10 000 partes.

Para obtener información sobre la carga multiparte, consulte Carga de archivos grandes por partes (carga multiparte).

Amazon Glacier (Amazon Glacier) rechaza su solicitud de carga de piezas si se cumple alguna de las siguientes condiciones:

  • SHA256 El hash de árbol no coincide: para garantizar que los datos de la parte no se dañen durante la transmisión, debe calcular un hash de SHA256 árbol de la parte e incluirlo en la solicitud. Al recibir los datos de la pieza, Amazon Glacier también calcula un hash de SHA256 árbol. Si los dos valores hash no coinciden, se producirá un error en la operación. Para obtener información sobre cómo calcular un hash de SHA256 árbol, consulteCálculo de sumas de comprobación.

  • SHA256 El hash lineal no coincide: necesario para la autorización, se calcula un hash SHA256 lineal de toda la carga cargada y se incluye en la solicitud. Para obtener información sobre cómo calcular un hash SHA256 lineal, consulteCálculo de sumas de comprobación.

  • El tamaño de la parte no coincide: el tamaño de cada una de las partes excepto de la última debe coincidir con el tamaño especificado en la solicitud Inicio de la carga multiparte (POST cargas-multiparte) correspondiente. El tamaño de la última parte debe ser igual o menor que el tamaño especificado.

    nota

    Si carga una parte cuyo tamaño es menor que el tamaño especificado en la solicitud Initiate Multipart Upload y esa parte no es la última, la solicitud Upload Part se ejecutará correctamente. Sin embargo, se producirá un error en la solicitud Complete Multipart Upload siguiente.

  • El intervalo no está alineado: el valor del intervalo de bytes de la solicitud no coincide con el tamaño de parte especificado en la solicitud de inicio correspondiente. Por ejemplo, si especifica un tamaño de parte de 4 194 304 bytes (4 MB), entonces los intervalos de 0 a 4 194 303 bytes (4 MB - 1) y de 4 194 304 (4 MB) a 8 388 607 (8 MB - 1) son intervalos de partes válidos. Sin embargo, si establece un valor de intervalo de 2 MB a 6 MB, el intervalo no estará alineado con el tamaño de la parte y la carga no se realizará correctamente.

Esta operación es idempotente. Si carga la misma parte varias veces, los datos incluidos en la solicitud más reciente sobrescribirán los datos cargados anteriormente.

Solicitudes

Puede enviar esta solicitud HTTP PUT al URI del ID de carga que devolvió la solicitud Initiate Multipart Upload. Amazon Glacier usa el ID de carga para asociar las cargas parciales con una carga multiparte específica. La solicitud debe incluir un hash de SHA256 árbol de los datos de la parte (x-amz-SHA256-tree-hashencabezado), un hash SHA256 lineal de toda la carga útil (x-amz-content-sha256encabezado), el rango de bytes (Content-Rangeencabezado) y la longitud de la parte en bytes (Content-Lengthencabezado).

Sintaxis

PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Range: ContentRange
Content-Length: PayloadSize
Content-Type: application/octet-stream
x-amz-sha256-tree-hash: Checksum of the part
x-amz-content-sha256: Checksum of the entire payload			
x-amz-glacier-version: 2012-06-01

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
Content-Length

Identifica la longitud de la parte en bytes.

Tipo: cadena

Valor predeterminado: None

Restricciones: ninguna

 No
Content-Range

Identifica el intervalo de bytes del archivo montado que se va a cargar en esta parte. Amazon Glacier utiliza esta información para reunir el archivo en la secuencia adecuada. El formato de este encabezado sigue la especificación RFC 2616. Un encabezado de ejemplo podría ser Content-Range:bytes 0-4194303/*.

Tipo: cadena

Valor predeterminado: None

Restricciones: el intervalo no puede ser mayor que el tamaño de parte que especificó al iniciar la carga multiparte.

Sí
x-amz-content-sha256

La SHA256 suma de comprobación (un hash lineal) de la carga útil cargada. No es el mismo valor que se especifica en el encabezado x-amz-sha256-tree-hash.

Tipo: cadena

Valor predeterminado: None

Restricciones: ninguna

 Sí
x-amz-sha256-tree-hash​

Especifica un hash de SHA256 árbol de los datos que se están cargando. Para obtener información sobre cómo calcular un hash de SHA256 árbol, consulteCálculo de sumas de comprobación.

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

Si la carga de una pieza se realiza correctamente, Amazon Glacier devuelve una 204 No Content respuesta.

Sintaxis

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier

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
x-amz-sha256-tree-hash​

El hash de SHA256 árbol que Amazon Glacier calculó para la parte cargada.

Tipo: cadena

Cuerpo de respuesta

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

Ejemplo

La siguiente solicitud carga una parte de 4 MB. La solicitud define el intervalo de bytes que se va a convertir en la primera parte del archivo.

Solicitud de ejemplo

El ejemplo envía una solicitud HTTP PUT para cargar una parte de 4 MB. La solicitud se envía al URI del ID de carga que devolvió la solicitud Initiate Multipart Upload. El encabezado Content-Range identifica la parte como los primeros 4 MB de datos del archivo.

PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Range:bytes 0-4194303/*
x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
Content-Length: 4194304
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

Para cargar la siguiente pieza, el procedimiento es el mismo; sin embargo, debe calcular un nuevo hash de SHA256 árbol de la pieza que está cargando y también especificar un nuevo rango de bytes para indicar dónde se ubicará la pieza en el ensamblaje final. La siguiente solicitud carga otra parte con el mismo ID de carga. La solicitud especifica los siguientes 4 MB del archivo tras la solicitud anterior y un tamaño de parte de 4 MB.

PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Range:bytes 4194304-8388607/*
Content-Length: 4194304
x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
x-amz-glacier-version: 2012-06-01
Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace

Las piezas se pueden cargar en cualquier orden; Amazon Glacier utiliza la especificación de rango de cada pieza para determinar el orden en el que se ensamblarán.

Respuesta de ejemplo

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
Date: Wed, 10 Feb 2017 12:00:00 GMT