Cabeçalhos de solicitação comuns

Entre as solicitações REST do Amazon S3 Glacier (S3 Glacier) estão cabeçalhos que contêm informações básicas sobre a solicitação. A tabela a seguir descreve os cabeçalhos que podem ser usados por todas as solicitações REST do S3 Glacier.

Nome do cabeçalho	Descrição	Obrigatório
Authorization	O cabeçalho obrigatório para assinar solicitações. O S3 Glacier exige o Signature versão 4. Para obter mais informações, consulte Solicitações de assinatura. Tipo: string	Sim
Content-Length	O tamanho do corpo da solicitação (sem os cabeçalhos). Tipo: string Condição: obrigatório somente para a API Upload Archive (POST archive).	Condicional
Date	A data que pode ser usada para criar a assinatura contida no cabeçalho Authorization. Se o cabeçalho Date precisar ser usado na assinatura, ele deverá ser especificado no formato básico ISO 8601. Neste caso, o cabeçalho x-amz-date não é necessário. Observe que quando x-amz-date está presente, ele sempre substitui o valor do cabeçalho Date. Se o cabeçalho Data não for usado na assinatura, ele poderá ser um dos formatos de data completa especificados por RFC 2616, seção 3.3. Por exemplo, a seguinte data/hora Wed, 10 Feb 2017 12:00:00 GMT é um cabeçalho de data/hora válido para usar com o S3 Glacier. Se você estiver usando o cabeçalho Date para assinatura, ele deverá estar no formato YYYYMMDD'T'HHMMSS'Z' básico ISO 8601. Tipo: string Condição: se Date for especificado, mas não estiver em formato básico ISO 8601, você também deverá incluir o cabeçalho x-amz-date. Se Date for especificado em formato básico ISO 8601, isso será suficiente para assinar solicitações e você não precisar do cabeçalho x-amz-date. Para obter mais informações, consulte Tratamento de datas no Signature versão 4 no Glossário da Amazon Web Services.	Condicional
Host	Este cabeçalho especifica o endpoint de serviço para o qual você envia as solicitações. O valor deve ser da forma “glacier.region.amazonaws.com” em que region (região) é substituída por uma designação de Região da AWS, como us-west-2. Tipo: string	Sim
x-amz-content-sha256	A soma de verificação SHA256 computada de toda a carga útil cujo upload é feito com Upload Archive (POST archive) ou Upload Part (PUT uploadID). Esse cabeçalho não é igual ao cabeçalho x-amz-sha256-tree-hash, embora, para algumas pequenas cargas úteis, os valores sejam os mesmos. Quando x-amz-content-sha256 é obrigatório, x-amz-content-sha256 e x-amz-sha256-tree-hash devem ser especificados. Tipo: string Condição: obrigatório para API de streaming, Upload Archive (POST archive) e Upload Part (PUT uploadID).	Condicional
x-amz-date	A data usada para criar a assinatura no cabeçalho de autorização. O formato deve ser ISO 8601 básico no formato YYYYMMDD'T'HHMMSS'Z'. Por exemplo, a data/hora 20170210T120000Z a seguir é um x-amz-date válido a ser usado com o S3 Glacier. Tipo: string Condição: x-amz-date é opcional para todas as solicitações; ele pode ser usado para substituir a data usada em solicitações de assinatura. Se o cabeçalho Date for especificado no formato básico ISO 8601, x-amz-date não será necessário. Quando x-amz-date está presente, ele sempre substitui o valor do cabeçalho Date. Para obter mais informações, consulte Tratamento de datas no Signature versão 4 no Glossário da Amazon Web Services.	Condicional
x-amz-glacier-version	A versão da S3 Glacier API a ser usada. A versão atual é 2012-06-01. Tipo: string	Sim
x-amz-sha256-tree-hash	A soma de verificação do hash de árvore SHA256 para um arquivo cujo upload foi feito (Upload Archive (POST archive)) ou uma parte do arquivo (Upload Part (PUT uploadID)). Para obter mais informações sobre como calcular essa soma de verificação, consulte Computar somas de verificação. Tipo: string Padrão: nenhum Condição: obrigatório para Upload Archive (POST archive) e Upload Part (PUT uploadID).	Condicional