Création d'un coffre dans Amazon S3 Glacier à l'aide d'AWS SDK for .NET

Les API de haut et bas niveau fournies par le kit SDK Amazon pour .NET proposent une méthode de création de coffre.

Création d'un coffre à l'aide de l'API de haut niveau du kit AWS SDK for .NET

La classe ArchiveTransferManager de l'API de haut niveau propose la méthode CreateVault qui vous permet de créer un coffre dans une région AWS.

Exemple : Opération de coffre à l'aide de l'API de haut niveau du kit AWS SDK for .NET

L'exemple de code C# suivant crée et supprime un coffre dans la région USA Ouest (Oregon). Pour voir la liste des Régions AWS dans lesquelles vous pouvez créer des coffres, consultez Accès à Amazon 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 avec le nom du coffre, comme indiqué.

using System;
using Amazon.Glacier;
using Amazon.Glacier.Transfer;
using Amazon.Runtime;

namespace glacier.amazon.com.docsamples
{
  class VaultCreateDescribeListVaultsDeleteHighLevel
  {
    static string vaultName = "*** Provide vault name ***";

    public static void Main(string[] args)
    {
      try
      {
          var manager = new ArchiveTransferManager(Amazon.RegionEndpoint.USWest2);
          manager.CreateVault(vaultName);
          Console.WriteLine("Vault created. To delete the vault, press Enter");
          Console.ReadKey();
          manager.DeleteVault(vaultName);
          Console.WriteLine("\nVault deleted. 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();
    }
  }
}

Création d'un coffre à l'aide de l'API de bas niveau du kit AWS SDK for .NET

L'API de bas niveau propose des méthodes pour toutes les opérations liées aux coffres : création et suppression de coffres, obtention de la description d'un coffre, obtention de la liste des coffres créés dans une Région AWS déterminée, etc. Voici les étapes de création d'un coffre à l'aide de AWS SDK for .NET.

1. Créez une instance de la classe AmazonGlacierClient (le client).

   Vous devez spécifier la Région AWS dans laquelle vous souhaitez créer un coffre. Toutes les opérations que vous effectuez à l'aide de ce client s'appliquent à cette Région AWS.

2. Fournissez les informations de demande en créant une instance de la classe CreateVaultRequest.

   Amazon S3 Glacier (S3 Glacier) vous demande de fournir un nom de coffre et l'ID de votre compte. Si vous n'indiquez pas d'ID de compte, l'ID de compte associé aux informations d'identification que vous avez indiquées pour signer la demande est pris en compte. Pour de plus amples informations, veuillez consulter Utilisation d'AWS SDK for .NET avec Amazon S3 Glacier.

3. Exécutez la méthode CreateVault en fournissant l'objet de demande comme paramètre.

   La réponse renvoyée par S3 Glacier est disponible dans l'objet CreateVaultResponse.

Exemple : Opérations de coffre à l'aide de l'API de bas niveau du kit AWS SDK for .NET

L'exemple de code C# suivant illustre les étapes précédentes. Cet exemple crée un coffre dans la région USA Ouest (Oregon). Par ailleurs, l'exemple de code extrait les informations de coffre, affiche la liste de tous les coffres situés dans une même Région AWS, puis supprime le coffre créé. L'emplacement Location imprimé est l'URI relatif du coffre qui comprend l'ID de votre compte, la Région AWS et le nom du coffre.

Note

Pour obtenir des informations sur l'API REST sous-jacente, consultez la section Création de coffre (PUT vault).

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 avec le nom du coffre, comme indiqué.

using System;
using Amazon.Glacier;
using Amazon.Glacier.Model;
using Amazon.Runtime;

namespace glacier.amazon.com.docsamples
{
  class VaultCreateDescribeListVaultsDelete
  {
    static string vaultName = "*** Provide vault name ***";
    static AmazonGlacierClient client;

    public static void Main(string[] args)
    {
       try
      {
         using (client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2))
        {
          Console.WriteLine("Creating a vault.");
          CreateAVault();
          DescribeVault();
          GetVaultsList();
          Console.WriteLine("\nVault created. Now press Enter to delete the vault...");
          Console.ReadKey();
          DeleteVault();
        }
      }
      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();
    }

    static void CreateAVault()
    {
      CreateVaultRequest request = new CreateVaultRequest()
      {
        VaultName = vaultName
      };
      CreateVaultResponse response = client.CreateVault(request);
      Console.WriteLine("Vault created: {0}\n", response.Location); 
    }

    static void DescribeVault()
    {
      DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest()
      {
        VaultName = vaultName
      };
   
      DescribeVaultResponse describeVaultResponse = client.DescribeVault(describeVaultRequest);
      Console.WriteLine("\nVault description...");
      Console.WriteLine(
        "\nVaultName: " + describeVaultResponse.VaultName +
        "\nVaultARN: " + describeVaultResponse.VaultARN +
        "\nVaultCreationDate: " + describeVaultResponse.CreationDate +
        "\nNumberOfArchives: " + describeVaultResponse.NumberOfArchives +
        "\nSizeInBytes: " + describeVaultResponse.SizeInBytes +
        "\nLastInventoryDate: " + describeVaultResponse.LastInventoryDate 
        );
    }

    static void GetVaultsList()
    {
      string lastMarker = null;
      Console.WriteLine("\n List of vaults in your account in the specific region ...");
      do
      {
        ListVaultsRequest request = new ListVaultsRequest()
        {
          Marker = lastMarker
        };
        ListVaultsResponse response = client.ListVaults(request);
         
        foreach (DescribeVaultOutput output in response.VaultList)
        {
          Console.WriteLine("Vault Name: {0} \tCreation Date: {1} \t #of archives: {2}",
                            output.VaultName, output.CreationDate, output.NumberOfArchives); 
        }
        lastMarker = response.Marker;
      } while (lastMarker != null);
    }

    static void DeleteVault()
    {
      DeleteVaultRequest request = new DeleteVaultRequest()
      {
        VaultName = vaultName
      };
      DeleteVaultResponse response = client.DeleteVault(request);
    }
  }
}