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 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.

Encabezados de solicitudes comunes

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

Nombre del encabezado Descripción Obligatorio
Authorization

Encabezado necesario para firmar solicitudes. Amazon Glacier requiere la versión 4 de Signature. 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, la siguiente fecha/hora Wed, 10 Feb 2017 12:00:00 GMT es un date/time encabezado 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«y debe sustituirse por region una designación de AWS región, como. us-west-2

Tipo: cadena

 Sí
x-amz-content-sha256

La SHA256 suma de comprobación calculada de toda una carga útil que se carga con una u Carga de archivo (POST archivo) otra. 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, lo siguiente date/time 20170210T120000Z es válido x-amz-date para su uso 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

La 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

La suma de comprobación calculada en forma de SHA256 árbol hash 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