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

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á.

Trabalhando 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 (Amazon Glacier). Cada arquivo tem uma ID exclusiva e uma descrição opcional. Quando você carrega um arquivo, o Amazon Glacier retorna uma resposta que inclui um ID de arquivamento. Esse ID de arquivamento é exclusivo na AWS região em que o arquivo está armazenado. Este é um ID de arquivo de exemplo. 

TJgHcrOSfAkV6hdPqOATYfp_0ZaxL1pIBOc02iZ0gDPMr2ig-nhwd_PafstsdIf6HSrjHnP-3p6LCJClYytFT_CBhT9CwNxbRaM5MetS3I-GqwxI3Y8QtgbJbhEQPs0mJ3KExample

O arquivo IDs tem 138 bytes de comprimento. 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 fornece 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 código. Por exemplo, para fazer upload de dados, como fotos, vídeos e outros documentos, você deve usar o código AWS CLI ou escrever o código para fazer solicitações, usando a API REST diretamente ou usando a Amazon SDKs. Para obter mais informações sobre o uso do Amazon Glacier com o AWS CLI, acesse AWS CLI Referência do Amazon Glacier. Para instalar o AWS CLI, acesse AWS Command Line Interface.

Tópicos

Operações de arquivamento no Amazon Glacier

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

Fazendo o upload de 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 Fazendo o upload de um arquivo no Amazon Glacier.

Importante

O Amazon Glacier fornece 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 código. Por exemplo, para fazer upload de dados, como fotos, vídeos e outros documentos, você deve usar o código AWS CLI ou escrever o código para fazer solicitações, usando a API REST diretamente ou usando a Amazon SDKs. Para obter mais informações sobre o uso do Amazon Glacier com o AWS CLI, acesse AWS CLI Referência do Amazon Glacier. Para instalar o AWS CLI, acesse AWS Command Line Interface.

Encontrando 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 Baixando um inventário do Vault 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 seu arquivo para download. Depois que o trabalho é concluído, você pode fazer download dos dados do arquivo. Devido à 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.

Excluindo um arquivo no Amazon Glacier

O Amazon Glacier fornece uma chamada de API que você pode usar para excluir um arquivo por vez. Para obter mais informações, consulte Excluindo um arquivo no Amazon Glacier.

Atualização de 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. Observe que toda vez que você faz o upload de um arquivo, o Amazon Glacier retorna a você um ID de arquivamento exclusivo.

Manter metadados de arquivo no lado do cliente

Exceto pela descrição opcional do arquivo, o Amazon Glacier não oferece suporte a nenhum metadado adicional para os arquivos. Quando você carrega um arquivo, o Amazon Glacier atribui um ID, uma sequência opaca de caracteres, a partir da qual você não pode deduzir 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, você não pode atribuir uma chave de objeto aos arquivos que você carrega.

Se você mantém metadados de arquivamento do lado do cliente, observe que o Amazon Glacier mantém um inventário do cofre que inclui o arquivo IDs 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 do cofre aproximadamente diariamente. Quando você solicita um inventário de cofre, o Amazon Glacier retorna o inventário preparado mais recentemente, um snapshot point-in-time.