Chargement d'une archive sur un coffre dans S3 Glacier à l'aide d'AWS SDK for .NET - Amazon S3 Glacier

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 et Classes de stockage pour l'archivage d'objets dans le guide de l'utilisateur Amazon S3.

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.

Chargement d'une archive sur un coffre dans S3 Glacier à l'aide d'AWS SDK for .NET

L'exemple de code C# suivant utilise l'API de haut niveau du kit AWS SDK for .NET pour charger un exemple d'archive dans le coffre. Dans l'exemple de code, notez les éléments suivants :

  • L'exemple crée une instance de la classe ArchiveTransferManager pour le point de terminaison de la région Amazon S3 Glacier spécifiée.

  • Cet exemple utilise la région USA Ouest (Oregon) (us-west-2).

  • L'exemple utilise l'opération d'API Upload de la classe ArchiveTransferManager pour charger votre archive. Pour les petites archives, cette opération charge l'archive directement sur S3 Glacier. Pour les archives volumineuses, cette opération utilise l'API de chargement partitionné dans S3 Glacier pour fractionner le chargement en plusieurs parties, ceci afin d'assurer une meilleure récupération d'erreur, si des erreurs sont rencontrées pendant le streaming des données vers S3 Glacier.

Pour obtenir les instructions étape par étape sur la façon d'exécuter l'exemple suivant, consultez la section Exemples de code en cours d'exécution. Vous devez mettre à jour le code tel qu'il est présenté avec le nom de votre coffre et le nom du fichier d'archive à charger.

Note

S3 Glacier tient un inventaire de toutes les archives contenues dans vos coffres. Lorsque vous chargez l'archive dans l'exemple suivant, elle n'apparaît pas dans un coffre dans la console de gestion tant que l'inventaire du coffre n'a pas été mis à jour. Cette mise à jour a lieu habituellement une fois par jour.

Exemple – Chargement d'une archive à l'aide de l'API de haut niveau d'AWS SDK for .NET
using System; using Amazon.Glacier; using Amazon.Glacier.Transfer; using Amazon.Runtime; namespace glacier.amazon.com.docsamples { class ArchiveUploadHighLevel_GettingStarted { static string vaultName = "examplevault"; static string archiveToUpload = "*** Provide file name (with full path) to upload ***"; public static void Main(string[] args) { try { var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2); // Upload an archive. string archiveId = manager.Upload(vaultName, "getting started archive test", archiveToUpload).ArchiveId; Console.WriteLine("Copy and save the following Archive ID for the next step."); Console.WriteLine("Archive ID: {0}", archiveId); Console.WriteLine("To continue, press Enter"); Console.ReadKey(); } catch (AmazonGlacierException e) { Console.WriteLine(e.Message); } catch (AmazonServiceException e) { Console.WriteLine(e.Message); } catch (Exception e) { Console.WriteLine(e.Message); } Console.WriteLine("To continue, press Enter"); Console.ReadKey(); } } }