Trabalhar com arquivos no Amazon Glacier - Amazon Glacier
Operações de arquivoManter metadados de arquivo no lado do cliente

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.

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 com suas próprias APIs que armazena dados em cofres e é diferente das classes de armazenamento do 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, a AWS recomenda as classes de armazenamento do Amazon S3 Glacier, que oferecem uma experiência superior ao cliente com APIs baseadas em bucket do S3, disponibilidade total da Região da AWS, custos mais baixos e integração de serviços da 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.

Trabalhar com arquivos no Amazon Glacier

Um arquivo é qualquer objeto, como uma foto, um vídeo ou um documento, armazenado por você em um cofre. É uma unidade básica de armazenamento no Amazon Glacier. Cada arquivo tem uma ID exclusiva e uma descrição opcional. Ao fazer upload de um arquivo, o Amazon Glacier retorna uma resposta que inclui um ID de arquivo. Esse ID de arquivo é exclusivo na AWS região onde o arquivo está armazenado. Este é um ID de arquivo de exemplo. 

TJgHcrOSfAkV6hdPqOATYfp_0ZaxL1pIBOc02iZ0gDPMr2ig-nhwd_PafstsdIf6HSrjHnP-3p6LCJClYytFT_CBhT9CwNxbRaM5MetS3I-GqwxI3Y8QtgbJbhEQPs0mJ3KExample

Os IDs de arquivo têm 138 bytes. Ao fazer upload de um arquivo, você pode apresentar uma descrição opcional. Você pode recuperar um arquivo usando o ID, mas não a descrição.

Importante

O Amazon Glacier oferece um console de gerenciamento. Você pode usar o console para criar e excluir cofres. No entanto, todas as outras interações com o Amazon Glacier exigem que você use a AWS Command Line Interface (CLI) ou escreva o código. Por exemplo, para fazer upload de dados, como fotos, vídeos e outros documentos, você deve usar a AWS CLI ou escrever código para fazer solicitações usando a API REST diretamente ou usando os SDKs da Amazon. Para obter mais informações sobre como usar o Amazon Glacier com AWS CLI, acesse a Referência da AWS CLI para o Amazon Glacier. Para instalar a AWS CLI, acesse a AWS Command Line Interface.

Tópicos

Operações de arquivamento no Amazon Glacier

O Amazon Glacier dá suporte às seguintes operações de arquivo básicas: upload, download e exclusão. Fazer download de um arquivo é uma operação assíncrona.

Carregar um arquivo no Amazon Glacier

Você pode fazer upload de um arquivo em uma única operação ou fazer upload dele em partes. A chamada à API usada por você para fazer upload de um arquivo em partes é conhecida como Multipart Upload. Para obter mais informações, consulte Carregar um arquivo no Amazon Glacier.

Importante

O Amazon Glacier oferece um console de gerenciamento. Você pode usar o console para criar e excluir cofres. No entanto, todas as outras interações com o Amazon Glacier exigem que você use a AWS Command Line Interface (CLI) ou escreva o código. Por exemplo, para fazer upload de dados, como fotos, vídeos e outros documentos, você deve usar a AWS CLI ou escrever código para fazer solicitações usando a API REST diretamente ou usando os SDKs da Amazon. Para obter mais informações sobre como usar o Amazon Glacier com AWS CLI, acesse a Referência da AWS CLI para o Amazon Glacier. Para instalar a AWS CLI, acesse a AWS Command Line Interface.

Encontre um ID de arquivo no Amazon Glacier

Você pode obter o ID de arquivo fazendo download do inventário do cofre que contém o arquivo. Para obter mais informações sobre como fazer download do inventário de cofre, consulte Fazer download de um inventário de cofre no Amazon Glacier.

Baixando um arquivo no Amazon Glacier

Fazer download de um arquivo é uma operação assíncrona. Você deve primeiro iniciar um trabalho para fazer download de um arquivo específico. Depois de receber a solicitação de trabalho, o Amazon Glacier prepara o arquivo para download. Depois que o trabalho é concluído, você pode fazer download dos dados do arquivo. Por causa da natureza assíncrona do trabalho, você pode solicitar que o Amazon Glacier envie uma notificação para um tópico do Amazon Simple Notification Service (Amazon SNS) quando o trabalho for concluído. Você pode especificar um tópico do SNS para cada solicitação de trabalho individual ou configurar o cofre para enviar uma notificação quando ocorrerem eventos específicos. Para obter mais informações sobre como fazer download de um arquivo, consulte Baixando um arquivo no Amazon Glacier.

Excluir um arquivo no Amazon Glacier

O Amazon Glacier fornece uma chamada de API que pode ser usada para excluir um arquivo por vez. Para obter mais informações, consulte Excluir um arquivo no Amazon Glacier.

Atualizar um arquivo no Amazon Glacier

Depois de fazer upload de um arquivo, você não poderá atualizar o conteúdo nem a descrição. A única maneira como você pode atualizar o conteúdo do arquivo ou a descrição é excluindo o arquivo e fazendo upload de outro arquivo. Sempre que você faz upload de um arquivo, o Amazon Glacier retorna um ID de arquivo exclusivo.

Manter metadados de arquivo no lado do cliente

Exceto para a descrição de arquivo opcional, o Amazon Glacier não dá suporte a metadados adicionais dos arquivos. Quando se faz upload de um arquivo, o Amazon Glacier atribui um ID, uma sequência de caracteres invisível, do qual não se pode inferir nenhum significado sobre o arquivo. Você pode manter metadados sobre os arquivos no lado do cliente. Os metadados podem incluir o nome do arquivo e algumas outras informações significativas sobre o arquivo.

nota

Se for um cliente do Amazon Simple Storage Service (Amazon S3), você saberá que, ao fazer upload de um objeto em um bucket, você pode atribuir ao objeto uma chave, como MyDocument.txt ou SomePhoto.jpg. No Amazon Glacier, não é possível atribuir um chave de objeto aos arquivos com upload.

Se você mantiver metadados de arquivo no lado do cliente, observe que o Amazon Glacier manterá um inventário de cofre que inclui IDs de arquivo e todas as descrições fornecidas durante o upload do arquivo. Ocasionalmente, você pode fazer download do inventário de cofre para reconciliar todos os problemas no banco de dados no lado do cliente dos metadados do arquivo. No entanto, o Amazon Glacier faz o inventário de cofre quase que diariamente. Quando você solicita um inventário de cofre, o Amazon Glacier retorna o inventário preparado mais recentemente, um snapshot point-in-time.