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
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengunduh Inventaris Vault di Amazon Glacier
Setelah Anda mengunggah arsip pertama Anda ke brankas Anda, Amazon Glacier (Amazon Glacier) secara otomatis membuat inventaris vault dan kemudian memperbaruinya kira-kira sekali sehari. Setelah Amazon Glacier membuat inventaris pertama, biasanya dibutuhkan setengah hari dan hingga sehari sebelum inventaris itu tersedia untuk diambil. Anda dapat mengambil inventaris vault dari Amazon Glacier dengan proses dua langkah berikut:
-
Mulai tugas pengambilan inventaris menggunakan operasi Memulai Tugas (POST jobs).
penting
Kebijakan pengambilan data dapat menyebabkan permintaan tugas pengambilan awal Anda gagal dengan pengecualian
PolicyEnforcedException. Untuk informasi selengkapnya tentang kebijakan pengambilan data, lihat Kebijakan Pengambilan Data Amazon Glacier. Untuk informasi selengkapnya tentang pengecualianPolicyEnforcedException, lihat Respons Kesalahan. -
Setelah tugas selesai, unduh byte menggunakan operasi Mendapatkan Output Tugas (GET output).
Misalnya, mengambil arsip atau inventaris vault mengharuskan Anda memulai tugas pengambilan terlebih dahulu. Permintaan tugas dijalankan secara asinkron. Saat Anda memulai pekerjaan pengambilan, Amazon Glacier membuat pekerjaan dan mengembalikan ID pekerjaan dalam respons. Saat Amazon Glacier menyelesaikan pekerjaan, Anda bisa mendapatkan output pekerjaan, byte arsip, atau data inventaris vault.
Tugas harus selesai sebelum Anda bisa mendapatkan outputnya. Untuk menentukan status tugas, Anda memiliki opsi berikut:
-
Tunggu pemberitahuan penyelesaian pekerjaan —Anda dapat menentukan topik Amazon Simple Notification Service (Amazon SNS) tempat Amazon Glacier dapat memposting pemberitahuan setelah pekerjaan selesai. Anda dapat menentukan topik Amazon SNS menggunakan metode berikut:
Tentukan topik Amazon SNS per tugas.
Ketika Anda memulai tugas, Anda dapat secara opsional menentukan topik Amazon SNS.
Atur konfigurasi notifikasi di vault.
Anda dapat menetapkan konfigurasi notifikasi untuk peristiwa tertentu di vault (lihat Mengkonfigurasi Pemberitahuan Vault di Amazon Glacier). Amazon Glacier mengirim pesan ke topik SNS yang ditentukan setiap kali peristiwa tertentu terjadi.
Jika konfigurasi notifikasi disetel di vault dan Anda juga menentukan topik Amazon SNS saat memulai pekerjaan, Amazon Glacier mengirimkan pesan penyelesaian pekerjaan ke kedua topik tersebut.
Anda dapat mengonfigurasi topik SNS untuk memberi tahu Anda melalui email atau menyimpan pesan di Amazon Simple Queue Service (Amazon SQS) yang dapat dibuat polling oleh aplikasi Anda. Ketika pesan muncul di antrean, Anda dapat memeriksa apakah tugas berhasil diselesaikan, lalu mengunduh output tugas.
-
Minta informasi pekerjaan secara eksplisit —Amazon Glacier juga menyediakan deskripsi operasi pekerjaan (Mendeskripsikan Tugas (GET JobID)) yang memungkinkan Anda melakukan polling untuk informasi pekerjaan. Anda dapat mengirim permintaan ini secara berkala untuk mendapatkan informasi tugas. Namun, menggunakan notifikasi Amazon SNS adalah opsi yang disarankan.
catatan
Informasi yang Anda dapatkan melalui notifikasi SNS sama dengan informasi yang Anda dapatkan dengan memanggil Jelaskan Tugas.
Topik
Tentang Inventaris
Amazon Glacier memperbarui inventaris brankas setidaknya sekali per hari, dimulai pada hari Anda pertama kali mengunggah arsip ke lemari besi. Jika tidak ada penambahan arsip atau penghapusan vault sejak inventaris terakhir, tanggal inventaris tidak diperbarui. Saat Anda memulai pekerjaan untuk inventaris vault, Amazon Glacier mengembalikan inventaris terakhir yang dihasilkannya, yang merupakan point-in-time snapshot dan bukan data real-time. Perhatikan bahwa setelah Amazon Glacier membuat inventaris pertama untuk lemari besi, biasanya dibutuhkan setengah hari dan hingga sehari sebelum inventaris tersebut tersedia untuk diambil.
Anda mungkin merasa mengambil inventaris vault untuk setiap unggahan arsip tidak berguna. Namun, misalkan Anda memelihara database di sisi klien terkait metadata tentang arsip yang Anda unggah ke Amazon Glacier. Selanjutnya, Anda mungkin merasa inventaris vault berguna untuk mencocokkan informasi, jika perlu, dalam basis data Anda dengan inventaris vault aktual. Anda dapat membatasi jumlah item inventaris yang diambil dengan memfilter tanggal pembuatan arsip atau dengan menetapkan batas. Untuk informasi selengkapnya tentang membatasi pengambilan inventaris, lihat Pengambilan Inventaris Rentang.
Inventaris dapat dikembalikan dalam dua format, nilai yang dipisahkan oleh koma (CSV) atau JSON. Anda secara opsional dapat menentukan format ketika Anda memulai tugas inventaris. Format default adalah JSON. Untuk informasi selengkapnya tentang bidang data yang dikembalikan dalam output tugas inventaris, lihat Isi Respons dari API Dapatkan Output Tugas.
