Encabezados de solicitudes comunes - Amazon Glacier

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, que ofrecen una experiencia del cliente superior con las API basadas en buckets de S3, 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 AWSGuía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

Encabezados de solicitudes comunes

Las solicitudes REST de Amazon Glacier (Amazon Glacier) contienen encabezados con información básica sobre la solicitud. En la siguiente tabla se describen los encabezados que se pueden utilizar en todas las solicitudes REST de Amazon Glacier.

Nombre del encabezado Descripción Obligatorio
Authorization

Encabezado necesario para firmar solicitudes. Amazon Glacier necesita Signature Version 4. Para obtener más información, consulte Firmar solicitudes.

Tipo: cadena

 Sí
Content-Length

Longitud del cuerpo de la solicitud (sin los encabezados).

Tipo: cadena

Condición: solo es obligatorio con la API Carga de archivo (POST archivo).

Condicional
Date

Fecha que se puede utilizar para crear la firma incluida en el encabezado Authorization. Si el encabezado Date se va a utilizar para firmar, debe especificarse en el formato básico de la norma ISO 8601. En ese caso, el encabezado x-amz-date no es necesario. Tenga en cuenta que, cuando x-amz-date está presente, anula siempre el valor del encabezado Date.

Si el encabezado Date (Fecha) no se utiliza para firmar, puede tener uno de los formatos de fecha completa que se especifican en RFC 2616, sección 3.3. Por ejemplo, el siguiente valor de fecha y hora Wed, 10 Feb 2017 12:00:00 GMT es un encabezado de fecha/hora válido para su uso con Amazon Glacier.

Si utiliza el encabezado Date para firmar, debe tener el formato YYYYMMDD'T'HHMMSS'Z' básico de la norma ISO 8601.

Tipo: cadena

Condición: si se especifica Date pero no tiene el formato básico de la norma ISO 8601, debe incluirse también el encabezado x-amz-date. Si Date se especifica con el formato básico de la norma ISO 8601, este encabezado es suficiente para firmar las solicitudes y no se necesita el encabezado x-amz-date. Para obtener más información, consulte Control de fechas en Signature Version 4 en el Glosario de Amazon Web Services.

Condicional
Host

Este encabezado especifica el punto de enlace de servicio al que se envían las solicitudes. El valor debe tener el formato "glacier.region.amazonaws.com", donde region debe sustituirse por el nombre de una región de AWS, por ejemplo, us-west-2.

Tipo: cadena

 Sí
x-amz-content-sha256

Suma de comprobación SHA256 calculada de todos los datos cargados con Carga de archivo (POST archivo) o Carga de partes (PUT uploadID). Este encabezado no es igual que x-amz-sha256-tree-hash; sin embargo, en algunas cargas pequeñas, los valores son los mismos. Cuando x-amz-content-sha256 es obligatorio, debe especificarse x-amz-content-sha256 y x-amz-sha256-tree-hash.

Tipo: cadena

Condición: es necesario para la API de streaming, Carga de archivo (POST archivo) y Carga de partes (PUT uploadID).

 Condicional
x-amz-date

La fecha que se utiliza para crear la firma en el encabezado de autorización. El formato debe ser el formato básico de la norma ISO 8601 YYYYMMDD'T'HHMMSS'Z'. Por ejemplo, el siguiente valor de fecha y hora 20170210T120000Z es un encabezado x-amz-date válido que puede utilizarse con Amazon Glacier.

Tipo: cadena

Condición: x-amz-date es opcional en todas las solicitudes; puede utilizarse para anular la fecha empleada para firmar solicitudes. Si el encabezado Date se especifica en el formato básico de la norma ISO 8601, x-amz-date no es necesario. Cuando x-amz-date está presente, anula siempre el valor del encabezado Date. Para obtener más información, consulte Control de fechas en Signature Version 4 en el Glosario de Amazon Web Services.

Condicional
x-amz-glacier-version

Versión de la API de Amazon Glacier que se va a utilizar. La versión actual es 2012-06-01.

Tipo: cadena

 Sí
x-amz-sha256-tree-hash

Suma de comprobación del hash en árbol SHA256 que se calcula para un archivo cargado (Carga de archivo (POST archivo)) o una parte del archivo (Carga de partes (PUT uploadID)). Para obtener más información sobre el cálculo de esta suma de comprobación, consulte Cálculo de sumas de comprobación.

Tipo: cadena

Valor predeterminado: None

Condición: es necesario en Carga de archivo (POST archivo) y Carga de partes (PUT uploadID).

 Condicional