Mengambil Metadata Vault di Amazon S3 Glacier Menggunakan AWS SDK for Java

Mengambil Metadata Vault untuk Vault

Anda dapat mengambil metadata untuk vault tertentu atau semua vault dalam Wilayah AWS tertentu. 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 harus menentukan Wilayah AWS lokasi vault. Semua operasi yang Anda lakukan menggunakan klien ini berlaku untuk Wilayah AWS tersebut.

2. Berikan informasi permintaan dengan membuat instans kelas DescribeVaultRequest.

   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 Java dengan Amazon S3 Glacier.

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

   Informasi metadata vault yang S3 Glacier kembalikan 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).

Mengambil Metadata Vault untuk Semua Vault dalam Wilayah

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

Potongan kode Java berikut mengambil daftar vault di Wilayah us-west-2. Permintaan membatasi jumlah vault yang dikembalikan dalam merespons 5. Potongan kode selanjutnya membuat serangkaian panggilan listVaults 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 nilai Limit dalam permintaan, S3 Glacier mengembalikan hingga 10 vault, sebagaimana ditetapkan oleh API S3 Glacier. 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)).

Contoh: Mengambil Metadata Vault Menggunakan Amazon SDK for Java

Untuk contoh kode kerja, lihat Contoh: Contoh: Membuat Vault Menggunakan AWS SDK for Java. Contoh kode Java membuat vault dan mengambil metadata vault.