Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les sections Classes de stockage S3 Glacier et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent Amazon S3API, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de chiffrement optionnelles avancées, etc.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Modèle de données Amazon S3 Glacier

Les composants fondamentaux du modèle de données Amazon S3 Glacier sont notamment les coffres et les archives. S3 Glacier est un service web basé sur REST. En termes REST, les coffres et les archives sont les ressources. Par ailleurs, le modèle de données S3 Glacier comprend des ressources de configuration des tâches et des notifications. Ces ressources viennent compléter les ressources de base.

Coffre-fort

Dans S3 Glacier, un coffre est un conteneur destiné à stocker des archives. Un coffre est comparable à un compartiment Amazon S3. Lorsque vous créez un coffre-fort, vous spécifiez un nom et choisissez l' Région AWS endroit où vous souhaitez le créer.

Chaque ressource de coffre possède une adresse unique. Son format général est :

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

Par exemple, supposez que vous créez un coffre (examplevault) dans la région USA Ouest (Oregon) de votre compte avec l'ID 111122223333. Vous pouvez attribuer une adresse à ce coffre en utilisant l'URI suivant :

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

Voici la signification des différents composants de l'URI :

Et Compte AWS peut créer des coffres-forts dans tous les coffres-forts pris en charge Région AWS. Pour la liste des produits pris en charge Régions AWS, voirAccès à Amazon S3 Glacier. Dans une région, un compte doit utiliser des noms de coffre uniques. Et Compte AWS peut créer des coffres-forts portant le même nom dans différentes régions.

Vous pouvez stocker un nombre illimité d'archives dans un coffre. En fonction de vos besoins commerciaux ou de ceux de votre application, vous pouvez stocker ces archives dans un seul coffre ou plusieurs coffres.

S3 Glacier prend en charge diverses opérations de coffre. Les opérations liées aux coffres portent sur une région spécifique. Par exemple, lorsque vous créez un coffre, la création est effectuée pour une région spécifique. Lorsque vous demandez une liste de coffres-forts, vous la demandez à une personne spécifique Région AWS, et la liste qui en résulte inclut uniquement les coffres-forts créés dans cette région spécifique.

Archivage

Une archive peut être constituée de tout type de données : une photo, une vidéo ou un document. Une archive est comparable à un objet Amazon S3 et constitue l'unité de stockage de base dans S3 Glacier. Chaque archive est associée à un ID unique et une description en option. Vous ne pouvez spécifier cette description facultative qu'au cours du chargement d'une archive. S3 Glacier attribue à l'archive un identifiant unique dans celui Région AWS dans lequel l'archive est stockée.

Chaque archive possède une adresse unique. En général, sont format est le suivant :

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

Voici un exemple d'URI qui représente une archive stockée dans le coffre examplevault dans la région USA Ouest (Oregon) pour le compte 111122223333 :

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

Vous pouvez stocker un nombre illimité d'archives dans un coffre.

Tâche

Une tâche S3 Glacier peut extraire une archive ou obtenir l'inventaire d'un coffre.

Les extractions d'archives et d'inventaires de coffre (listes d'archives) sont des opérations asynchrones dans S3 Glacier, où vous lancez d'abord une tâche et téléchargez ensuite la sortie de la tâche une fois que S3 Glacier l'a terminée.

Pour lancer une tâche d'inventaire de coffre, vous fournissez un nom de coffre. Les tâches d'extraction d'archive requièrent le nom du coffre et l'ID de l'archive. Vous pouvez également indiquer une description facultative de la tâche pour permettre d'identifier les tâches.

Les tâches d'extraction d'archive et d'inventaire de coffre sont associées à un coffre. Un coffre peut avoir plusieurs tâches en cours à un moment donné. Lorsque vous envoyez une demande de tâche (lancement d'une tâche), S3 Glacier vous renvoie un ID de tâche pour suivre la tâche. Chaque tâche est identifiée de façon unique par un URI au format suivant :

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

Voici l'exemple d'une tâche associée à un coffre examplevault dans la région USA Ouest (Oregon) pour le compte 111122223333.

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

Pour chaque tâche, S3 Glacier tient à jour des informations, telles que le type, la description, la date de création, la date d'achèvement et le statut de la tâche. Vous pouvez obtenir des informations sur une tâche spécifique ou obtenir la liste de toutes vos tâches associées à un coffre. La liste des tâches renvoyées par S3 Glacier comprend toutes les tâches en cours et récemment terminées.

Configuration des notifications

Sachant que l'exécution des tâches prend un certain temps, S3 Glacier prend en charge un mécanisme de notification pour vous avertir lorsqu'une tâche se termine. Vous pouvez configurer un coffre de sorte qu'il envoie une notification à une rubrique Amazon Simple Notification Service (Amazon SNS) lorsqu'une tâche se termine. Vous pouvez spécifier une seule rubrique Amazon SNS par coffre dans la configuration de notifications.

S3 Glacier stocke la configuration de notifications sous forme de document JSON. Le texte suivant est un exemple de configuration de notifications :

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

Les configurations de notifications sont associées à des coffres ; il ne peut en exister qu'une seule par coffre. Chaque ressource de configuration de notifications est identifiée de façon unique par un URI au format suivant :

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

S3 Glacier prend en charge les opérations permettant de définir, obtenir et supprimer une configuration de notifications. Lorsque vous supprimez une configuration de notifications, aucune notification n'est envoyée à la fin d'une opération d'extraction de données dans le coffre.