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	Sí
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	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: 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	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: String Valor predeterminado: None Condición: es necesario en Carga de archivo (POST archivo) y Carga de partes (PUT uploadID).	Condicional