

 **Halaman ini hanya untuk pelanggan lama layanan Amazon Glacier menggunakan Vaults dan REST API asli dari 2012.**

Jika Anda mencari solusi penyimpanan arsip, sebaiknya gunakan kelas penyimpanan Amazon Glacier di Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat kelas penyimpanan [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak lagi menerima pelanggan baru. Amazon Glacier adalah layanan mandiri dengan miliknya APIs sendiri yang menyimpan data di brankas dan berbeda dari Amazon S3 dan kelas penyimpanan Amazon S3 Glacier. Data Anda yang ada akan tetap aman dan dapat diakses di Amazon Glacier tanpa batas waktu. Tidak diperlukan migrasi. Untuk penyimpanan arsip jangka panjang berbiaya rendah, AWS rekomendasikan kelas [penyimpanan Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan [Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke kelas penyimpanan Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengambil Metadata Vault di Amazon Glacier
<a name="retrieving-vault-info"></a>

Anda dapat mengambil informasi vault seperti tanggal pembuatan vault, jumlah arsip di vault, dan ukuran total semua arsip di vault. Amazon Glacier (Amazon Glacier) menyediakan panggilan API bagi Anda untuk mengambil informasi ini untuk brankas tertentu atau semua brankas di Wilayah tertentu di akun Anda. AWS 

Jika Anda mengambil daftar vault, Amazon Glacier mengembalikan daftar yang diurutkan berdasarkan nilai ASCII dari nama vault. Daftar ini berisi hingga 1.000 vault. Anda harus selalu memeriksa respons untuk penanda tempat untuk melanjutkan daftar; jika tidak ada lagi item, bidang penanda adalah `null`. Anda dapat secara opsional membatasi jumlah vault yang dikembalikan dalam respons. Jika ada lebih banyak vault daripada yang dikembalikan dalam respons, hasilnya adalah pemberian nomor halaman. Anda perlu mengirim permintaan tambahan untuk mengambil sekumpulan vault berikutnya. 

**Topics**
+ [Mengambil Metadata Vault di Amazon Glacier Menggunakan AWS SDK untuk Java](retrieving-vault-info-sdk-java.md)
+ [Mengambil Metadata Vault di Amazon Glacier Menggunakan AWS SDK untuk .NET](retrieving-vault-info-sdk-dotnet.md)
+ [Mengambil Metadata Vault menggunakan REST API](listing-vaults-rest-api.md)
+ [Mengambil Metadata Vault di Amazon Glacier Menggunakan AWS Command Line Interface](retrieving-vault-info-cli.md)

# Mengambil Metadata Vault di Amazon Glacier Menggunakan AWS SDK untuk Java
<a name="retrieving-vault-info-sdk-java"></a>

**Topics**
+ [Mengambil Metadata Vault untuk Vault](#retrieve-vault-info-sdk-java-lowlevel-one-vault)
+ [Mengambil Metadata Vault untuk Semua Vault dalam Wilayah](#retrieve-vault-info-sdk-java-lowlevel-all-vaults)
+ [Contoh: Mengambil Metadata Vault Menggunakan Amazon SDK for Java](#retrieving-vault-info-sdk-java-example)

## Mengambil Metadata Vault untuk Vault
<a name="retrieve-vault-info-sdk-java-lowlevel-one-vault"></a>

Anda dapat mengambil metadata untuk brankas tertentu atau semua brankas di Wilayah tertentu. AWS Berikut adalah langkah-langkah mengambil metadata vault untuk vault tertentu menggunakan API tingkat rendah dari Amazon SDK for Java. 

 

1. Buat instans dari kelas `AmazonGlacierClient` (klien). 

   Anda perlu menentukan AWS Wilayah tempat brankas berada. Semua operasi yang Anda lakukan menggunakan klien ini berlaku untuk AWS Wilayah tersebut.

1. Berikan informasi permintaan dengan membuat instans kelas `DescribeVaultRequest`.

   Amazon Glacier (Amazon Glacier) mengharuskan Anda untuk memberikan nama vault dan ID akun Anda. Jika Anda tidak memberikan ID akun, ID akun yang terkait dengan kredensial yang Anda berikan untuk menandatangani permintaan diambil. Untuk informasi selengkapnya, lihat [Menggunakan AWS SDK untuk Java dengan Amazon Glacier](using-aws-sdk-for-java.md).

1. Jalankan metode `describeVault` dengan menyediakan objek permintaan sebagai parameter. 

   Informasi metadata vault yang dikembalikan Amazon Glacier tersedia di objek. `DescribeVaultResult`

Potongan kode Java berikut menggambarkan langkah-langkah sebelumnya. 

```
DescribeVaultRequest request = new DescribeVaultRequest()
	.withVaultName("*** provide vault name***");

DescribeVaultResult result = client.describeVault(request);

System.out.print(
        "\nCreationDate: " + result.getCreationDate() +
        "\nLastInventoryDate: " + result.getLastInventoryDate() +
        "\nNumberOfArchives: " + result.getNumberOfArchives() + 
        "\nSizeInBytes: " + result.getSizeInBytes() + 
        "\nVaultARN: " + result.getVaultARN() + 
        "\nVaultName: " + result.getVaultName());
```

 

**catatan**  
Untuk informasi tentang REST API yang mendasarinya, lihat [Menjelaskan Vault (GET vault)](api-vault-get.md). 

## Mengambil Metadata Vault untuk Semua Vault dalam Wilayah
<a name="retrieve-vault-info-sdk-java-lowlevel-all-vaults"></a>

Anda juga dapat menggunakan `listVaults` metode ini untuk mengambil metadata untuk semua vault di Wilayah tertentu. AWS 

Potongan kode Java berikut mengambil daftar vault di Wilayah `us-west-2`. Permintaan membatasi jumlah vault yang dikembalikan dalam merespons 5. Cuplikan kode kemudian membuat serangkaian `listVaults` panggilan untuk mengambil seluruh daftar vault dari Wilayah. AWS 

 

```
AmazonGlacierClient client;
client.setEndpoint("https://glacier.us-west-2.amazonaws.com/");

String marker = null;
do {            
    ListVaultsRequest request = new ListVaultsRequest()
        .withLimit("5")
        .withMarker(marker);
    ListVaultsResult listVaultsResult = client.listVaults(request);
    
    List<DescribeVaultOutput> vaultList = listVaultsResult.getVaultList();
    marker = listVaultsResult.getMarker();
    for (DescribeVaultOutput vault : vaultList) {
        System.out.println(
                "\nCreationDate: " + vault.getCreationDate() +
                "\nLastInventoryDate: " + vault.getLastInventoryDate() +
                "\nNumberOfArchives: " + vault.getNumberOfArchives() + 
                "\nSizeInBytes: " + vault.getSizeInBytes() + 
                "\nVaultARN: " + vault.getVaultARN() + 
                "\nVaultName: " + vault.getVaultName()); 
    }
} while (marker != null);
```

Di segmen kode sebelumnya, jika Anda tidak menentukan `Limit` nilai dalam permintaan, Amazon Glacier mengembalikan hingga 10 vault, seperti yang ditetapkan oleh Amazon Glacier API. Jika ada lebih banyak vault yang dicantumkan, bidang `marker` respons berisi vault Amazon Resource Name (ARN) tempat untuk melanjutkan daftar dengan permintaan baru; jika tidak, bidang `marker` adalah null. 

Perhatikan bahwa informasi yang dikembalikan untuk setiap vault dalam daftar sama dengan informasi yang Anda dapatkan dengan memanggil metode `describeVault` untuk vault tertentu. 

 

**catatan**  
Metode `listVaults` memanggil REST API yang mendasarinya (lihat [Mencantumkan Vault (GET vaults)](api-vaults-get.md)). 

## Contoh: Mengambil Metadata Vault Menggunakan Amazon SDK for Java
<a name="retrieving-vault-info-sdk-java-example"></a>

Untuk contoh kode kerja, lihat [Contoh: Membuat Vault Menggunakan AWS SDK untuk Java](creating-vaults-sdk-java.md#creating-vaults-sdk-java-example). Contoh kode Java membuat vault dan mengambil metadata vault.

# Mengambil Metadata Vault di Amazon Glacier Menggunakan AWS SDK untuk .NET
<a name="retrieving-vault-info-sdk-dotnet"></a>

**Topics**
+ [Mengambil Metadata Vault untuk Vault](#retrieve-vault-info-sdk-dotnet-lowlevel-one-vault)
+ [Mengambil Metadata Vault untuk Semua Vault dalam Wilayah](#retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults)
+ [Contoh: Mengambil Metadata Vault Menggunakan API Tingkat Rendah AWS SDK untuk .NET](#creating-vaults-sdk-dotnet-example)

## Mengambil Metadata Vault untuk Vault
<a name="retrieve-vault-info-sdk-dotnet-lowlevel-one-vault"></a>

Anda dapat mengambil metadata untuk brankas tertentu atau semua brankas di Wilayah tertentu. AWS Berikut adalah langkah-langkah mengambil metadata vault untuk vault tertentu menggunakan API tingkat rendah dari AWS SDK untuk .NET. 

 

1. Buat instans dari kelas `AmazonGlacierClient` (klien). 

   Anda perlu menentukan AWS Wilayah tempat brankas berada. Semua operasi yang Anda lakukan menggunakan klien ini berlaku untuk AWS Wilayah tersebut.

1. Berikan informasi permintaan dengan membuat instans kelas `DescribeVaultRequest`.

   Amazon Glacier (Amazon Glacier) mengharuskan Anda untuk memberikan nama vault dan ID akun Anda. Jika Anda tidak memberikan ID akun, ID akun yang terkait dengan kredensial yang Anda berikan untuk menandatangani permintaan diambil. Untuk informasi selengkapnya, lihat [Menggunakan AWS SDK untuk .NET dengan Amazon Glacier](using-aws-sdk-for-dot-net.md).

1. Jalankan metode `DescribeVault` dengan menyediakan objek permintaan sebagai parameter. 

   Informasi metadata vault yang dikembalikan Amazon Glacier tersedia di objek. `DescribeVaultResult`

Potongan kode C\$1 berikut menggambarkan langkah-langkah sebelumnya. Potongan mengambil informasi metadata dari vault yang ada di Wilayah US West (Oregon). 

```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);

DescribeVaultRequest describeVaultRequest = new DescribeVaultRequest()
{
  VaultName = "*** Provide vault name ***"
};  
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 
   );
```

 

**catatan**  
Untuk informasi tentang REST API yang mendasarinya, lihat [Menjelaskan Vault (GET vault)](api-vault-get.md). 

## Mengambil Metadata Vault untuk Semua Vault dalam Wilayah
<a name="retrieve-vault-info-sdk-dotnet-lowlevel-all-vaults"></a>

Anda juga dapat menggunakan `ListVaults` metode ini untuk mengambil metadata untuk semua vault di Wilayah tertentu. AWS 

Potongan kode C\$1 berikut mengambil daftar vault di Wilayah US West (Oregon). Permintaan membatasi jumlah vault yang dikembalikan dalam merespons 5. Cuplikan kode kemudian membuat serangkaian `ListVaults` panggilan untuk mengambil seluruh daftar vault dari Wilayah. AWS 

 

```
AmazonGlacierClient client;
client = new AmazonGlacierClient(Amazon.RegionEndpoint.USWest2);
string lastMarker = null;
Console.WriteLine("\n List of vaults in your account in the specific AWS Region ...");
do
{
  ListVaultsRequest request = new ListVaultsRequest()
  {
    Limit = 5,
    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);
```

Di segmen kode sebelumnya, jika Anda tidak menentukan `Limit` nilai dalam permintaan, Amazon Glacier mengembalikan hingga 10 vault, seperti yang ditetapkan oleh Amazon Glacier API. 

Perhatikan bahwa informasi yang dikembalikan untuk setiap vault dalam daftar sama dengan informasi yang Anda dapatkan dengan memanggil metode `DescribeVault` untuk vault tertentu. 

 

**catatan**  
Metode `ListVaults` memanggil REST API yang mendasarinya (lihat [Mencantumkan Vault (GET vaults)](api-vaults-get.md)). 

## Contoh: Mengambil Metadata Vault Menggunakan API Tingkat Rendah AWS SDK untuk .NET
<a name="creating-vaults-sdk-dotnet-example"></a>

Untuk contoh kode pekerjaan, lihat [Contoh: Operasi Vault Menggunakan API Tingkat Rendah AWS SDK untuk .NET](creating-vaults-dotnet-sdk.md#vault-operations-example-dotnet-lowlevel). Contoh kode C\$1 membuat vault dan mengambil metadata vault.

# Mengambil Metadata Vault menggunakan REST API
<a name="listing-vaults-rest-api"></a>

Untuk mencantumkan vault menggunakan REST API, lihat [Mencantumkan Vault (GET vaults)](api-vaults-get.md). Untuk mendeskripsikan satu vault, lihat [Menjelaskan Vault (GET vault)](api-vault-get.md).

# Mengambil Metadata Vault di Amazon Glacier Menggunakan AWS Command Line Interface
<a name="retrieving-vault-info-cli"></a>

Contoh ini menunjukkan cara mengambil informasi vault dan metadata di Amazon Glacier (Amazon Glacier) menggunakan (). AWS Command Line Interface AWS CLI

**Topics**
+ [(Prasyarat) Menyiapkan AWS CLI](#Creating-Vaults-CLI-Setup)
+ [Contoh: Mengambil Metadata Vault Menggunakan AWS CLI](#Retrieving-Vault-Metadata-CLI-Implementation)

## (Prasyarat) Menyiapkan AWS CLI
<a name="Creating-Vaults-CLI-Setup"></a>

1. Unduh dan konfigurasikan AWS CLI. Untuk melakukannya, lihat topik berikut di *Panduan Pengguna AWS Command Line Interface *: 

    [Memasang AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) 

   [Mengkonfigurasi AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)

1. Verifikasi AWS CLI pengaturan Anda dengan memasukkan perintah berikut pada prompt perintah. Perintah ini tidak memberikan kredensial secara eksplisit, sehingga kredensial profil default digunakan.
   + Coba gunakan perintah bantuan.

     ```
     aws help
     ```
   + Untuk mendapatkan daftar brankas Amazon Glacier pada akun yang dikonfigurasi, gunakan perintah. `list-vaults` Ganti *123456789012* dengan Akun AWS ID Anda.

     ```
     aws glacier list-vaults --account-id 123456789012
     ```
   + Untuk melihat data konfigurasi saat ini untuk AWS CLI, gunakan `aws configure list` perintah.

     ```
     aws configure list
     ```

## Contoh: Mengambil Metadata Vault Menggunakan AWS CLI
<a name="Retrieving-Vault-Metadata-CLI-Implementation"></a>
+ Gunakan `describe-vault` perintah untuk mendeskripsikan vault bernama *awsexamplevault* di bawah akun*111122223333*.

  ```
  aws glacier describe-vault --vault-name awsexamplevault --account-id 111122223333
  ```