Modelo de dados do Amazon S3 Glacier - Amazon S3 Glacier
CofreArquivoTrabalhoConfiguração de notificação

Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e o original de 2012. REST API

Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 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 Classes de armazenamento S3 Glacier e Armazenamento de dados de longo prazo usando classes de armazenamento S3 Glacier no Guia do usuário do Amazon S3. Essas classes de armazenamento usam o Amazon S3API, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Eles oferecem recursos como análise de custos de armazenamento, lente de armazenamento, recursos avançados de criptografia opcional e muito mais.

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

Modelo de dados do Amazon S3 Glacier

Os principais componentes do modelo de dados do Amazon S3 Glacier incluem cofres e arquivos. S3 Glacier é um serviço web baseado em REST. Em termos de REST, cofres e arquivos são os recursos. Além disso, o modelo de dados do S3 Glacier inclui recursos de configuração da notificação. Esses recursos complementam os recursos básicos.

Cofre

No S3 Glacier, um cofre é um contêiner para armazenar arquivos. Um cofre é semelhante a um bucket do Amazon S3. Ao criar um cofre, você especifica um nome e escolhe Região da AWS onde deseja criar o cofre.

Cada recurso do cofre tem um endereço exclusivo. A forma geral é: 

https://region-specific-endpoint/account-id/vaults/vault-name

Por exemplo, suponha que um cofre (examplevault) seja criado na região Oeste dos EUA (Oregon) em sua conta com o ID 111122223333. Esse cofre pode ser endereçado pelo seguinte URI: 

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault

Veja o que significam os vários componentes do URI:

  • glacier.us-west-2.amazonaws.com identifica a região Oeste dos EUA (Oregon).

  • 111122223333é o Conta da AWS ID que possui o cofre.

  • vaults se refere ao conjunto de cofres de propriedade da Conta da AWS.

  • examplevault identifica um cofre específico no conjunto de cofres.

E Conta da AWS pode criar cofres em qualquer um compatível. Região da AWS Para obter uma lista dos compatíveis Regiões da AWS, consulteAcessar o Amazon S3 Glacier. Em uma região, uma conta deve usar nomes de cofre exclusivos. E Conta da AWS pode criar cofres com o mesmo nome em diferentes regiões.

Você pode armazenar um número ilimitado de arquivos em um cofre. Dependendo das necessidades de negócios ou do aplicativo, você pode armazenar esses arquivos em um cofre ou em vários cofres.

O S3 Glacier dá suporte a diversas operações de cofre. As operações de cofre são específicas da região. Por exemplo, ao criar um cofre, você faz isso em uma região específica. Quando você solicita uma lista de cofres, você a solicita de uma determinada Região da AWS região, e a lista resultante inclui somente cofres criados nessa região específica.

Arquivo

Um arquivo pode conter quaisquer dados, como uma foto, um vídeo ou um documento. Um arquivamento é semelhante a um objeto do Amazon S3 e é a unidade básica de armazenamento no S3 Glacier. Cada arquivo tem uma ID exclusiva e uma descrição opcional. Você pode especificar esta descrição opcional somente durante o upload de um arquivo. O S3 Glacier atribui ao arquivo uma ID, que é exclusiva Região da AWS na qual o arquivo é armazenado.

Cada arquivo tem um endereço exclusivo. O formato geral é o seguinte: 

https://region-specific-endpoint/account-id/vaults/vault-name/archives/archive-id

Este é um URI de exemplo de um arquivo armazenado no cofre examplevault da região Oeste dos EUA (Oregon) na conta 111122223333: 

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

Você pode armazenar um número ilimitado de arquivos em um cofre.

Trabalho

Um trabalho do S3 Glacier pode ser iniciado para recuperar um arquivo ou obter um inventário de um cofre.

Recuperar um arquivo e um inventário de cofre (lista de arquivos) são operações assíncronas no Glacier S3 nas quais deve-se primeiro iniciar um trabalho e, então, fazer download da saída do trabalho depois que S3 Glacier concluir o trabalho.

nota

O S3 Glacier oferece uma solução de arquivamento de dados de armazenamento a frio. Se o aplicativo precisar de uma solução de armazenamento que exija recuperação de dados em tempo real, você poderá considerar o uso do Amazon S3. Para obter mais informações, vá até Amazon Simple Storage Service (Amazon S3).

Para iniciar um trabalho de inventário de cofre, você fornece um nome de cofre. Os trabalhos de seleção e de recuperação de arquivo exigem o nome do cofre e o ID do arquivo. Você também pode fornecer uma descrição de trabalho opcional para ajudar a identificar os trabalhos.

Os trabalhos de recuperação de arquivo e inventário de cofre estão associados a um cofre. Um cofre pode ter vários trabalhos em andamento a qualquer momento. Quando envia-se uma solicitação de trabalho (iniciar um trabalho), o S3 Glacier retorna um ID do trabalho para rastreá-lo. Cada trabalho é identificado com exclusividade por um URI da forma: 

https://region-specific-endpoint/account-id/vaults/vault-name/jobs/job-id

Veja a seguir um exemplo de um trabalho associado a um cofre examplevault na região Oeste dos EUA (Oregon) na conta 111122223333. 

https://glacier.us-west-2.amazonaws.com/111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID

Para cada trabalho, o S3 Glacier mantém informações como tipo de trabalho, descrição, data de criação, data de conclusão e status do trabalho. Você pode obter informações sobre um trabalho específico ou uma lista de todos os trabalhos associados a um cofre. A lista de trabalhos retornados pelo S3 Glacier inclui todos os trabalhos em andamento e concluídos recentemente.

Configuração de notificação

Como os trabalhos demoram para serem concluídos, o S3 Glacier dá suporte a um mecanismo de notificação para notificá-lo quando um trabalho for concluído. Você pode configurar um cofre para enviar uma notificação para um tópico do Amazon Simple Notification Service (Amazon SNS) quando um trabalho é concluído. É possível especificar um tópico do SNS por cofre na configuração de notificação.

O S3 Glacier armazena a configuração de notificação como um documento JSON. Este é um exemplo de configuração de notificação de cofre: 

{
   "Topic": "arn:aws:sns:us-west-2:111122223333:mytopic", 
   "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] 
}

As configurações de notificação são associadas a cofres; pode-se ter uma para cada cofre. Cada recurso de configuração de notificação é identificado com exclusividade por um URI da forma: 

https://region-specific-endpoint/account-id/vaults/vault-name/notification-configuration

O S3 Glacier dá suporte a operações para definir, obter e excluir uma configuração de notificação. Quando se exclui uma configuração de notificação, nenhuma notificação é enviada quando qualquer operação de recuperação de dados no cofre é concluída.