Menggunakan AWS SDK untuk Java dengan Amazon Glacier - Amazon Glacier
Menggunakan API Tingkat RendahMenggunakan API Tingkat TinggiMenjalankan Contoh Java Menggunakan EclipseMengatur Titik Akhir

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.

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak akan lagi menerima pelanggan baru mulai 15 Desember 2025, tanpa berdampak pada pelanggan yang sudah ada. 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, 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.

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

Menggunakan AWS SDK untuk Java dengan Amazon Glacier

AWS SDK untuk Java Ini menyediakan tingkat tinggi dan tingkat rendah APIs untuk Amazon Glacier (Amazon Glacier) seperti yang dijelaskan dalam. Menggunakan AWS SDKs dengan Amazon Glacier Untuk informasi tentang mengunduh AWS SDK untuk Java, lihat Amazon SDK for Java.

catatan

AWS SDK untuk Java Ini menyediakan klien yang aman untuk mengakses Amazon Glacier. Sebagai praktik terbaik, aplikasi Anda harus membuat satu klien dan menggunakan kembali klien di antara thread.

Menggunakan API Tingkat Rendah

AmazonGlacierClientKelas tingkat rendah menyediakan semua metode yang memetakan ke operasi REST yang mendasari Amazon Referensi API untuk Amazon Glacier Glacier (). Saat memanggil salah satu metode ini, Anda harus membuat objek permintaan yang sesuai dan memberikan objek respons di mana metode tersebut dapat mengembalikan respons Amazon Glacier ke operasi.

Misalnya, kelas AmazonGlacierClient menyediakan metode createVault untuk membuat vault. Metode ini memetakan ke operasi Buat REST Vault yang mendasarinya (lihat Membuat Vault (PUT vault)). Untuk menggunakan metode ini, Anda harus membuat instance CreateVaultResult objek yang menerima respons Amazon Glacier seperti yang ditunjukkan pada cuplikan kode Java berikut:

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

CreateVaultRequest request = new CreateVaultRequest()
    .withAccountId("-")
    .withVaultName(vaultName);
CreateVaultResult result = client.createVault(createVaultRequest);

Semua sampel tingkat rendah dalam panduan menggunakan pola ini.

catatan

Segmen kode sebelumnya menentukan AccountID ketika membuat permintaan. Namun, saat menggunakan AWS SDK untuk Java, permintaan AccountId dalam adalah opsional, dan oleh karena itu semua contoh tingkat rendah dalam panduan ini tidak menetapkan nilai ini. AccountIdIni adalah Akun AWS ID. Nilai ini harus cocok dengan Akun AWS ID yang terkait dengan kredensional yang digunakan untuk menandatangani permintaan. Anda dapat menentukan Akun AWS ID atau opsional '-', dalam hal ini Amazon Glacier Akun AWS menggunakan ID yang terkait dengan kredenal yang digunakan untuk menandatangani permintaan. Jika Anda menentukan ID Akun, jangan sertakan tanda hubung di dalamnya. Saat menggunakan AWS SDK untuk Java, jika Anda tidak memberikan ID akun, pustaka akan menyetel ID akun menjadi '-'.

Menggunakan API Tingkat Tinggi

Untuk lebih menyederhanakan pengembangan aplikasi Anda, AWS SDK untuk Java menyediakan ArchiveTransferManager kelas yang mengimplementasikan abstraksi tingkat yang lebih tinggi untuk beberapa metode di API tingkat rendah. Ini menyediakan metode yang berguna, seperti metode upload dan download, untuk operasi arsip.

Sebagai contoh, potongan kode Java berikut menggunakan metode tingkat tinggi upload untuk mengunggah arsip. 

String vaultName = "examplevault";
String archiveToUpload = "c:/folder/exampleArchive.zip";

ArchiveTransferManager atm = new ArchiveTransferManager(client, credentials);
String archiveId = atm.upload(vaultName, "Tax 2012 documents", new File(archiveToUpload)).getArchiveId();

Perhatikan bahwa operasi apa pun yang Anda lakukan berlaku untuk AWS Wilayah yang Anda tentukan saat membuat ArchiveTransferManager objek. Jika Anda tidak menentukan AWS Region apapun, AWS SDK untuk Java set us-east-1 sebagai AWS Region default.

Semua contoh tingkat tinggi dalam panduan ini menggunakan pola ini.

catatan

Kelas ArchiveTransferManager tingkat tinggi dapat dibangun dengan instans AmazonGlacierClient atau instans AWSCredentials.

Menjalankan Contoh Java untuk Amazon Glacier Menggunakan Eclipse

Cara termudah untuk memulai dengan contoh kode Java adalah dengan menginstal AWS Toolkit for Eclipse terbaru. Untuk informasi tentang menginstal atau memperbarui ke kit alat terbaru, buka http://aws.amazon.com/eclipse. Tugas-tugas berikut ini memandu Anda dalam pembuatan dan pengujian contoh kode Java yang disediakan dalam bagian ini.

Proses Umum Membuat Contoh Kode Java

1

Buat profil kredensial default untuk kredensional Anda seperti yang dijelaskan dalam AWS SDK untuk Java topik Menyediakan AWSAWS Kredensial di Amazon SDK for Java.

2

Buat proyek AWS Java baru di Eclipse. Proyek ini sudah dikonfigurasi sebelumnya dengan AWS SDK untuk Java.

3

Salin kode dari bagian yang sedang Anda baca ke proyek Anda.

4

 Perbarui kode dengan menyediakan data yang diperlukan. Misalnya, jika mengunggah file, berikan alur file dan nama bucket.

5

Jalankan kode. Verifikasi bahwa objek dibuat menggunakan AWS Management Console. Untuk informasi lebih lanjut tentang AWS Management Console, kunjungi http://aws.amazon.com/console/.

Mengatur Titik Akhir

Secara default, AWS SDK untuk Java menggunakan titik akhirhttps://glacier.us-east-1.amazonaws.com. Anda dapat mengatur titik akhir secara eksplisit seperti ditunjukkan dalam potongan kode Java berikut.

Potongan berikut menunjukkan cara mengatur titik akhir ke Wilayah US West (Oregon) (us-west-2) di API tingkat rendah.

client = new AmazonGlacierClient(credentials);
client.setEndpoint("glacier.us-west-2.amazonaws.com");

Potongan berikut menunjukkan cara mengatur titik akhir ke Wilayah US West (Oregon) di API tingkat tinggi.

glacierClient = new AmazonGlacierClient(credentials);
sqsClient = new AmazonSQSClient(credentials);
snsClient = new AmazonSNSClient(credentials);
        
glacierClient.setEndpoint("glacier.us-west-2.amazonaws.com");
sqsClient.setEndpoint("sqs.us-west-2.amazonaws.com");
snsClient.setEndpoint("sns.us-west-2.amazonaws.com");

ArchiveTransferManager atm = new ArchiveTransferManager(glacierClient, sqsClient, snsClient);

Untuk daftar AWS Wilayah dan titik akhir yang didukung, lihatMengakses Amazon Glacier.