Si vous débutez dans le stockage d'archives dans Amazon Simple Storage Service (Amazon S3), nous vous recommandons dans un premier temps de vous familiariser avec les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour plus d'informations, consultez les sections Classes de stockage 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 des AWS kits SDK avec Amazon S3 Glacier
AWS fournit des kits de développement logiciel vous permettant de développer des applications pour Amazon S3 Glacier. Les bibliothèques des kits SDK encapsulent l'API S3 Glacier sous-jacente, ce qui simplifie vos tâches de programmation. Par exemple, pour chaque demande adressée à S3 Glacier, vous devez inclure une signature pour l'authentifier. Lorsque vous utilisez les bibliothèques du SDK, vous devez uniquement fournir vos informations d'identification de AWS sécurité dans votre code. Les bibliothèques calculent la signature nécessaire et l'incluent dans la demande envoyée à S3 Glacier. Les AWS SDK 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.
Rubriques
Le AWS Command Line Interface (AWS CLI) est un outil unifié pour gérer votre Services AWS, y compris S3 Glacier. Pour plus d'informations sur le téléchargement du AWS CLI, voir AWS Command Line Interface
AWS Bibliothèques SDK pour Java et .NET
Les AWS SDK pour Java et .NET proposent des bibliothèques wrapper de haut niveau et de bas niveau.
Vous pouvez trouver des exemples d'utilisation d'Amazon S3 Glacier en utilisant le guide du développeur AWS SDK for Java et AWS SDK for .NET tout au long de ce guide.
Qu'est-ce qu'une API de bas niveau ?
Les bibliothèques d'enveloppe de bas niveau correspondent étroitement à l'API REST (Informations de référence sur les API pour Amazon S3 Glacier) sous-jacente prise en charge par S3 Glacier. Pour chaque opération REST S3 Glacier, l'API de bas niveau propose une méthode correspondante, un objet de demande vous permettant de fournir les informations de la demande et un objet de réponse vous permettant de traiter la réponse de S3 Glacier. Les bibliothèques d'enveloppe de bas niveau constituent l'implémentation la plus complète des opérations S3 Glacier sous-jacentes.
Pour plus d'informations sur ces bibliothèques SDK, consultez les pages Utilisation d'AWS SDK for Java avec Amazon S3 Glacier et Utilisation d'AWS SDK for .NET avec Amazon S3 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. Par exemple :
-
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 de permettre à S3 Glacier de vous notifier l'achèvement de la tâche. 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 d'AWS SDK for Java avec Amazon S3 Glacier et Utilisation d'AWS SDK for .NET avec Amazon S3 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.
