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 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
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á.
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 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. 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 AWS CLI ou escrever 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 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 código. Por exemplo, para fazer upload de dados, como fotos, vídeos e outros documentos, você deve usar AWS CLI ou escrever 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
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ê 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 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.
