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
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á.
Upload Archive (POST archive)
Descrição
Essa operação adiciona um arquivo a um cofre. Para um upload bem-sucedido, os dados são mantidos de maneira durável. Em resposta, o Amazon Glacier (Amazon Glacier) retorna o ID do arquivo no cabeçalho x-amz-archive-id da resposta. Você deve salvar o ID do arquivo retornado, de maneira que possa acessar o arquivo depois.
Você deve fornecer um hash de SHA256 árvore dos dados que você está carregando. Para obter informações sobre como calcular um hash de SHA256 árvore, consulteComputar somas de verificação.
nota
O hash da SHA256 árvore só é necessário para a ação Upload Archive (POST archive) ao usar a API. Não é necessário ao usar AWS CLI o.
Ao fazer upload de um arquivo, você pode especificar uma descrição de arquivo de até 1.024 caracteres ASCII imprimíveis. O Amazon Glacier retorna a descrição do arquivo quando você recupera o arquivo ou obtém o inventário do cofre. O Amazon Glacier não interpreta a descrição de forma alguma. Uma descrição de arquivo não precisa ser exclusiva. Você não pode usar a descrição para recuperar ou classificar a lista de arquivos.
Exceto pela descrição opcional do arquivo, o Amazon Glacier não oferece suporte a nenhum metadado adicional para os arquivos. O ID de arquivo é uma sequência de caracteres invisível da qual você não pode inferir nenhum significado sobre o arquivo. Assim, convém manter metadados sobre os arquivos no lado do cliente. Para obter mais informações, consulte Trabalhando com arquivos no Amazon Glacier.
Os arquivos são imutáveis. Depois de fazer upload de um arquivo, você não poderá editar o arquivo nem a descrição.
Solicitações
Para fazer upload de um arquivo, use o método HTTP POST e delimite a solicitação ao sub-recurso archives do cofre no qual você deseja salvar o arquivo. A solicitação deve incluir o tamanho da carga útil do arquivo, a soma de verificação (hash SHA256 da árvore) e, opcionalmente, pode incluir uma descrição do arquivamento.
Sintaxe
POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-Length:Length<Request body.>
nota
O AccountId valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '-' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
Parâmetros da solicitação
Essa implementação da operação não usa parâmetros de solicitação.
Cabeçalhos de solicitação
Essa operação usa os seguintes cabeçalhos de solicitação, além dos cabeçalhos de solicitação que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação comuns.
| Name (Nome) | Descrição | Obrigatório |
|---|---|---|
Content-Length
|
O tamanho do objeto em bytes. Para obter mais informações, acesse http://www.w3. org/Protocols/rfc2616/rfc2616-sec14.html #sec14 .13. Tipo: número Padrão: nenhum Restrições: nenhuma |
Sim |
x-amz-archive-description
|
A descrição opcional do arquivo cujo upload você está fazendo. Ela pode ser uma descrição em linguagem simples ou algum identificador que você opta por atribuir. A descrição não precisa ser exclusiva entre os arquivos. Quando você recupera um inventário de cofre (consulte Initiate Job (trabalhos POST)), ela inclui essa descrição para cada um dos arquivos retornados em resposta. Tipo: string Padrão: nenhum Restrições: a descrição deve ser menor que ou igual a 1.024 bytes caracteres. Os caracteres permitidos são ASCII 7 bits sem códigos de controle – mais especificamente, valores ASCII 32—126 decimais ou 0x20—0x7E hexadecimais. |
Não |
x-amz-content-sha256
|
A SHA256 soma de verificação (um hash linear) da carga útil. Ele não é o mesmo valor especificado por você no cabeçalho Tipo: string Padrão: nenhum Restrições: nenhuma |
Sim |
x-amz-sha256-tree-hash
|
A soma de verificação calculada pelo usuário, o hash SHA256 da árvore, da carga útil. Para obter informações sobre como calcular o hash da SHA256 árvore, consulteComputar somas de verificação. Se o Amazon Glacier computar uma soma de verificação diferente da carga, ele rejeitará a solicitação. Tipo: string Padrão: nenhum Restrições: nenhuma |
Sim |
Corpo da Solicitação
O corpo da solicitação contém os dados cujo upload deve ser feito.
Respostas
Em resposta, o Amazon Glacier armazena de forma durável o arquivo e retorna um caminho de URI para o ID do arquivo.
Sintaxe
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location x-amz-archive-id: ArchiveId
Cabeçalhos de resposta
Uma resposta bem-sucedida inclui os seguintes cabeçalhos de resposta, além dos cabeçalhos de resposta que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de resposta comuns, consulte Cabeçalhos de resposta comuns.
| Name (Nome) | Descrição |
|---|---|
Location
|
O caminho do URI relativo do recurso de arquivo recém-adicionado. Tipo: string |
x-amz-archive-id
|
O ID do arquivo. Esse valor também está incluído como parte do cabeçalho Tipo: String |
x-amz-sha256-tree-hash |
A soma de verificação do arquivo computado pelo Amazon Glacier. Tipo: String |
Corpo da resposta
Essa operação não retorna um corpo de resposta.
Erros
Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte. Respostas de erro
Exemplos
Exemplo de solicitação
O exemplo a seguir mostra uma solicitação para fazer upload de um arquivo.
POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace <Request body (2097152 bytes).>
Exemplo de resposta
A resposta bem-sucedida abaixo tem um Location cabeçalho onde você pode obter a ID que o Amazon Glacier atribuiu ao arquivo.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
Seções relacionadas
