Utilisation du AWS SDKs avec Amazon Glacier - Amazon Glacier

Cette page est réservée aux clients existants du service Amazon Glacier utilisant Vaults et l'API REST d'origine datant de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous recommandons d'utiliser les classes de stockage Amazon 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 classes de stockage Amazon Glacier.

Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'acceptera plus de nouveaux clients à compter du 15 décembre 2025, sans aucune incidence sur les clients existants. Amazon Glacier est un service autonome doté de son propre service APIs qui stocke les données dans des coffres-forts et qui se distingue des classes de stockage Amazon S3 et Amazon S3 Glacier. Vos données existantes resteront sécurisées et accessibles indéfiniment dans Amazon Glacier. Aucune migration n'est requise. Pour un stockage d'archivage à long terme et à faible coût AWS , nous recommandons les classes de stockage Amazon S3 Glacier, qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier.

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.

Utilisation du AWS SDKs avec Amazon Glacier

AWS vous permet SDKs de développer des applications pour Amazon Glacier. Les bibliothèques du SDK encapsulent l'API Amazon Glacier sous-jacente, simplifiant ainsi vos tâches de programmation. Par exemple, pour chaque demande envoyée à Amazon Glacier, vous devez inclure une signature afin d'authentifier vos demandes. Lorsque vous utilisez les bibliothèques du SDK, vous devez uniquement fournir vos informations de AWS sécurité dans votre code. Les bibliothèques calculent la signature nécessaire et l'incluent dans la demande envoyée à Amazon Glacier. Ils AWS SDKs fournissent des bibliothèques qui correspondent à l'API REST sous-jacente et fournissent des objets que vous pouvez utiliser pour créer facilement des demandes et traiter des réponses.

Le AWS Command Line Interface (AWS CLI) est un outil unifié qui permet de gérer votre Services AWS, y compris Amazon Glacier. Pour plus d'informations sur le téléchargement du AWS CLI, voir AWS Command Line Interface. Pour obtenir la liste des commandes de la CLI Amazon Glacier, consultez la référence des AWS CLI commandes.

AWS Bibliothèques SDK pour Java et .NET

AWS SDKs Pour Java et .NET, vous trouverez des bibliothèques wrapper de haut niveau et de bas niveau.

Vous trouverez des exemples d'utilisation d'Amazon Glacier en consultant le guide du développeur AWS SDK pour Java et l' AWS SDK pour .NET ensemble de ce guide.

Qu'est-ce qu'une API de bas niveau ?

Les bibliothèques wrapper de bas niveau mappent étroitement l'API REST sous-jacente (Référence d'API pour Amazon Glacier) prise en charge par Amazon Glacier. Pour chaque opération REST Amazon Glacier, l'API de bas niveau fournit une méthode correspondante, un objet de demande pour que vous fournissiez les informations de demande et un objet de réponse pour que vous puissiez traiter la réponse d'Amazon Glacier. Les bibliothèques d'encapsulation de bas niveau constituent l'implémentation la plus complète des opérations sous-jacentes d'Amazon Glacier.

Pour plus d'informations sur ces bibliothèques SDK, consultez les pages Utilisation du AWS SDK pour Java avec Amazon Glacier et Utilisation du AWS SDK pour .NET avec Amazon Glacier.

Qu'est-ce qu'une API de haut niveau ?

Pour simplifier davantage le développement d'applications, ces bibliothèques offrent une abstraction de niveau supérieur pour certaines opérations. Exemples :

  • Chargement d'une archive : pour charger une archive à l'aide de l'API de bas niveau, outre le nom du fichier et le nom du coffre dans lequel vous souhaitez enregistrer l'archive, vous devez fournir un total de contrôle (hachage d'arborescence SHA-256) de la charge utile. Toutefois, l'API de haut niveau calcule le total de contrôle pour vous.

  • Téléchargement d'une archive ou d'un inventaire de coffre : pour télécharger une archive en utilisant l'API de bas niveau, vous devez d'abord lancer une tâche, attendre qu'elle se termine, puis obtenir la sortie correspondante. Vous devez écrire du code supplémentaire pour configurer une rubrique Amazon Simple Notification Service (Amazon SNS) afin qu'Amazon Glacier vous avertisse lorsque la tâche est terminée. Vous avez également besoin d'un mécanisme d'interrogation pour vérifier si un message de fin de tâche a été publié dans la rubrique. L'API de haut niveau fournit une méthode permettant de télécharger une archive qui s'occupe de toutes ces étapes. Vous spécifiez uniquement un ID d'archivage et un chemin d'accès du dossier dans lequel vous souhaitez enregistrer les données téléchargées.

Pour plus d'informations sur ces bibliothèques SDK, consultez les pages Utilisation du AWS SDK pour Java avec Amazon Glacier et Utilisation du AWS SDK pour .NET avec Amazon Glacier.

Quand utiliser l'API de haut niveau et celle de bas niveau

En général, si l'API de haut niveau fournit des méthodes dont vous avez besoin pour effectuer une opération, vous devez l'utiliser en raison de sa simplicité. Toutefois, si l'API de haut niveau n'offre pas la fonctionnalité recherchée, vous pouvez utiliser l'API de bas niveau. En outre, l'API de bas niveau permet un contrôle précis de l'opération comme logique de nouvelle tentative en cas de défaillance. Par exemple, lors du chargement d'une archive, l'API de haut niveau utilise la taille de fichier pour déterminer s'il faut charger l'archive en une seule opération ou utiliser l'API de chargement partitionné. L'API dispose également d'une logique de nouvelle tentative intégrée en cas de défaillance d'un chargement. Toutefois, votre application peut avoir besoin d'un contrôle plus précis sur ces décisions, auquel cas vous pouvez utiliser l'API de bas niveau.