Membuat Vault di Amazon S3 Glacier Menggunakan AWS SDK for .NET

API tingkat tinggi dan tingkat rendah yang disediakan oleh Amazon SDK for .NET menyediakan metode untuk membuat vault.

Membuat Vault Menggunakan API Tingkat Tinggi dari AWS SDK for .NET

Kelas ArchiveTransferManager dari API tingkat tinggi menyediakan metode CreateVault yang dapat Anda gunakan untuk membuat vault di Wilayah AWS.

Contoh: Operasi Vault Menggunakan API Tingkat Tinggi dariAWS SDK for .NET

Contoh kode C# berikut membuat dan menghapus vault di Wilayah US West (Oregon). Untuk daftarWilayah AWSdi mana Anda dapat membuat vault, lihatMengakses Amazon S3 Glacier.

Untuk step-by-step petunjuk tentang cara menjalankan contoh berikut, lihatMenjalankan Contoh Kode. Anda perlu memperbarui kode seperti yang ditunjukkan dengan nama vault.

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();
    }
  }
}

Membuat Vault Menggunakan API Tingkat Rendah dari AWS SDK for .NET

API tingkat rendah menyediakan metode untuk semua operasi vault, termasuk membuat dan menghapus vault, mendapatkan deskripsi vault, dan mendapatkan deskripsi vault, dan mendapatkan deskripsi vault yang dibuat dalamWilayah AWS. Berikut adalah langkah-langkah untuk membuat vault menggunakan AWS SDK for .NET.

1. Buat instans dari kelas AmazonGlacierClient (klien).

   Anda perlu menentukanWilayah AWSdi mana Anda ingin membuat vault. Semua operasi yang Anda lakukan menggunakan klien ini berlaku untuk ituWilayah AWS.

2. Berikan informasi permintaan dengan membuat instans kelas CreateVaultRequest.

   Amazon S3 Glacier (S3 Glacier) mengharuskan Anda memberi nama vault dan ID akun Anda. Jika Anda tidak memberikan ID akun, ID akun yang terkait dengan kredensial yang Anda berikan untuk menandatangani permintaan akan diambil. Untuk informasi selengkapnya, lihat Menggunakan AWS SDK for .NET dengan Amazon S3 Glacier.

3. Jalankan metode CreateVault dengan menyediakan objek permintaan sebagai parameter.

   Pengembalian respons S3 Glacier tersedia di objek CreateVaultResponse.

Contoh: Operasi Vault Menggunakan API Tingkat Rendah dariAWS SDK for .NET

Contoh kode C# berikut menjelaskan langkah sebelumnya. Contoh ini membuat vault di Wilayah US West (Oregon). Selain itu, contoh kode mengambil informasi vault, mencantumkan semua vault di yang samaWilayah AWS, dan kemudian menghapus lemari besi yang dibuat. ParameterLocationyang dicetak adalah URI relatif vault yang mencakup ID akun Anda,Wilayah AWS, dan nama vault.

catatan

Untuk informasi tentang REST API yang mendasarinya, lihat Membuat Vault (PUT vault).

Untuk step-by-step petunjuk tentang cara menjalankan contoh berikut, lihatMenjalankan Contoh Kode. Anda perlu memperbarui kode seperti yang ditunjukkan dengan nama vault.

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);
    }
  }
}