**Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.**
Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do 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 [Classes de armazenamento do Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).
O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. 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](https://aws.amazon.com/s3/storage-classes/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 nossas [Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).
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 retorna o ID de 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 árvore SHA256 dos dados cujo upload está fazendo. Para obter informações sobre como computar um hash de árvore SHA256, consulte [Computar somas de verificação](checksum-calculations.md).
**nota**
O hash da árvore SHA256 só é necessário para a ação Upload Archive (POST archive) ao usar a API. Não é necessário ao usar o AWS CLI.
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 de cofre. O Amazon Glacier não interpreta a descrição de maneira 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 para a descrição de arquivo opcional, o Amazon Glacier não dá suporte a metadados adicionais dos 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 [Trabalhar com arquivos no Amazon Glacier](working-with-archives.md).
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 de árvore SHA256) e pode incluir uma descrição do arquivo.
### Sintaxe
```
1. POST /AccountId/vaults/VaultName/archives
2. Host: glacier.Region.amazonaws.com
3. x-amz-glacier-version: 2012-06-01
4. Date: Date
5. Authorization: SignatureValue
6. x-amz-archive-description: Description
7. x-amz-sha256-tree-hash: SHA256 tree hash
8. x-amz-content-sha256: SHA256 linear hash
9. Content-Length: Length
10.
11.
```
**nota**
O valor de `AccountId` é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID da Conta da AWS ou, de opcionalmente, um '`-`' (hífen) único. Nesse caso, o Amazon Glacier usa o ID de Conta da AWS 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](api-common-request-headers.md).
| 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\$1sec14.13](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)](api-initiate-job-post.md)), 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 soma de verificação SHA256 (um hash linear) da carga útil. Ele não é o mesmo valor especificado por você no cabeçalho `x-amz-sha256-tree-hash`. Tipo: string Padrão: nenhum Restrições: nenhuma | Sim |
| x-amz-sha256-tree-hash | A soma de verificação computada pelo usuário, hash de árvore SHA256, da carga útil. Para obter informações sobre como computar o hash de árvore SHA256, consulte [Computar somas de verificação](checksum-calculations.md). Se calcular uma soma de verificação diferente da carga útil, o Amazon Glacier 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 maneira durável o arquivo e retorna um caminho de URI para o ID de arquivo.
### Sintaxe
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
5. Location: Location
6. 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](api-common-response-headers.md).
| 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 `Location`. Tipo: string |
| x-amz-sha256-tree-hash | A soma de verificação do arquivo computada 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](api-error-responses.md).
## Exemplos
### Exemplo de solicitação
O exemplo a seguir mostra uma solicitação para fazer upload de um arquivo.
```
1. POST /-/vaults/examplevault/archives HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3
6. Content-Length: 2097152
7. x-amz-glacier-version: 2012-06-01
8. 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
9.
10.
```
### Exemplo de resposta
A resposta bem-sucedida abaixo tem um cabeçalho `Location` onde você pode obter o ID atribuído pelo Amazon Glacier ao arquivo.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
6. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
## Seções relacionadas
+ [Trabalhar com arquivos no Amazon Glacier](working-with-archives.md)
+ [Fazer upload de arquivos grandes em partes (Multipart Upload)](uploading-archive-mpu.md)
+ [Delete Archive (DELETE archive)](api-archive-delete.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)