Trabalhando com arquivos no Amazon S3 Glacier - Amazon S3 Glacier

Se você for novato no armazenamento de arquivo no Amazon Simple Storage Service (Amazon S3), recomendamos que comece aprendendo mais sobre as classes de armazenamento do S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para obter mais informações, consulte Classes de armazenamento S3 Glacier e Classes de armazenamento para arquivamento de objetos no Guia do usuário do 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á.

Trabalhando com arquivos no Amazon S3 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 S3 Glacier (S3 Glacier). Cada arquivo tem uma ID exclusiva e uma descrição opcional. Ao fazer upload de um arquivo, o S3 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 S3 Glacier disponibiliza um console de gerenciamento. Você pode usar o console para criar e excluir cofres. No entanto, todas as outras interações com o S3 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 S3 Glacier com a AWS CLI, acesse AWS CLI Referência para S3 Glacier. Para instalar a AWS CLI, acesse a AWS Command Line Interface.

Operações de arquivamento no Amazon S3 Glacier

O S3 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.

Carregando um arquivo no Amazon S3 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 Carregando um arquivo no Amazon S3 Glacier.

Importante

O S3 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 S3 Glacier exigem o uso de AWS Command Line Interface (CLI) ou escrever o código. Por exemplo, para fazer upload de dados, como fotos, vídeos e outros documentos, 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 S3 Glacier com AWS CLI, acesse a AWS CLIReferência para S3 Glacier . Para instalar a AWS CLI, acesse a AWS Command Line Interface.

Encontre uma ID de arquivo no Amazon S3 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 vault no Amazon S3 Glacier.

Baixando um arquivo no Amazon S3 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 job, o S3 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 S3 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 Fazer download de um arquivo no S3 Glacier.

Excluindo um arquivo no Amazon S3 Glacier

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

Atualizar um arquivo no S3 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 S3 Glacier retorna um ID de arquivo exclusivo.

Manter metadados de arquivo no lado do cliente

Exceto para a descrição de arquivo opcional, o S3 Glacier não dá suporte a metadados adicionais dos arquivos. Quando se faz upload de um arquivo, o S3 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 S3 Glacier, não é possível atribuir um chave objeto aos arquivos com upload.

Se você mantiver metadados de arquivo no lado do cliente, observe que o S3 Glacier manterá um inventário de vault 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 S3 Glacier faz o inventário de vault quase que diariamente. Quando você solicita um inventário de vault, o S3 Glacier retorna o inventário preparado mais recentemente, um snapshot point-in-time.