Encabezados de solicitudes comunes - Amazon S3 Glacier

Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y el original de 2012. REST API

Si busca soluciones de almacenamiento de archivos, le sugerimos que utilice las clases de almacenamiento 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 y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan Amazon S3API, están disponibles en todas las regiones y se pueden gestionar en la consola de Amazon S3. Ofrecen funciones como el análisis de costos de almacenamiento, Storage Lens, funciones avanzadas de cifrado opcionales y más.

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 S3 Glacier (S3 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 S3 Glacier.

Nombre del encabezado Descripción Obligatorio
Authorization

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

Tipo: String

Content-Length

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

Tipo: String

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

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

Tipo: String

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: String

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: String

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

Tipo: String

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 S3 Glacier que se va a utilizar. La versión actual es 2012-06-01.

Tipo: String

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: String

Valor predeterminado: None

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

Condicional