Cabeçalhos de solicitação comuns - Amazon Glacier

Esta página é somente para clientes atuais do serviço Amazon Glacier que usam Vaults e a API REST original de 2012.

Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte as classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento Amazon S3 Glacier, que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Cabeçalhos de solicitação comuns

As solicitações REST do Amazon Glacier (Amazon Glacier) incluem 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 Amazon Glacier.

Nome do cabeçalho Descrição Obrigatório
Authorization

O cabeçalho obrigatório para assinar solicitações. O Amazon Glacier exige a versão 4 do Signature. 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 data/hora a seguir Wed, 10 Feb 2017 12:00:00 GMT é um date/time cabeçalho válido para uso com o Amazon 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 estar no formato "glacier.region.amazonaws.com“, onde region é substituído por uma designação de AWS região, comous-west-2.

Tipo: String

 Sim
x-amz-content-sha256

A SHA256 soma de verificação computada de uma carga inteira que é carregada com ou. Upload Archive (POST archive) 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, o seguinte date/time 20170210T120000Z é válido x-amz-date para uso com o Amazon 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 API do Amazon Glacier a ser usada. A versão atual é 2012-06-01.

Tipo: string

 Sim
x-amz-sha256-tree-hash

A soma de verificação computada SHA256 de hash de árvore para um arquivo carregado (Upload Archive (POST archive)) ou parte de 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