Mengunduh Inventaris Vault di Amazon S3 Glacier - Amazon S3 Glacier
Tentang Inventaris

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

Jika Anda mencari solusi penyimpanan arsip, kami sarankan untuk menggunakan kelas penyimpanan S3 Glacier di Amazon S3, Pengambilan Instan Gletser S3, Pengambilan Fleksibel Gletser S3, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat Kelas penyimpanan S3 Glacier dan Penyimpanan data jangka panjang menggunakan kelas penyimpanan S3 Glacier di Panduan Pengguna Amazon S3. Kelas penyimpanan ini menggunakan Amazon S3API, tersedia di semua wilayah, dan dapat dikelola dalam konsol Amazon S3. Mereka menawarkan fitur seperti Analisis Biaya Penyimpanan, Lensa Penyimpanan, fitur enkripsi opsional canggih, dan banyak lagi.

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 S3 Glacier

Setelah Anda mengunggah arsip pertama Anda ke vault Anda, Amazon S3 Glacier (S3 Glacier) secara otomatis membuat inventaris vault, lalu memperbarui sekitar sekali sehari. Setelah S3 Glacier membuat inventaris pertama, biasanya diperlukan waktu setengah hari dan sampai satu hari sebelum inventaris tersedia untuk diambil. Anda dapat mengambil inventaris vault dari S3 Glacier dengan proses dua langkah berikut:

  1. Mulai tugas pengambilan inventaris menggunakan operasi Initiate Job (POSTjobs).

    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 Gletser S3. Untuk informasi selengkapnya tentang pengecualian PolicyEnforcedException, lihat Respons Kesalahan.

  2. 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. Ketika Anda memulai tugas pengambilan, S3 Glacier membuat tugas dan mengembalikan ID tugas dalam respons. Ketika S3 Glacier menyelesaikan tugas, Anda bisa mendapatkan output tugas, byte arsip, atau data inventaris vault.

Tugas harus selesai sebelum Anda bisa mendapatkan outputnya. Untuk menentukan status tugas, Anda memiliki opsi berikut:

  • Tunggu notifikasi penyelesaian tugas—Anda dapat menentukan topik Amazon Simple Notification Service (Amazon SNS) tempat S3 Glacier dapat mengirim notifikasi setelah tugas 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 Mengonfigurasi Notifikasi Vault di Amazon S3 Glacier). S3 Glacier mengirimkan pesan ke topik SNS tertentu kapan pun peristiwa tertentu terjadi.

    Jika Anda menetapkan konfigurasi notifikasi di vault dan Anda juga menentukan topik Amazon SNS ketika Anda memulai tugas, S3 Glacier mengirimkan pesan penyelesaian tugas untuk kedua topik.

    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 tugas secara eksplisit—S3 Glacier juga menyediakan operasi jelaskan tugas (Mendeskripsikan Tugas (GET JobID)) yang memungkinkan Anda melakukan polling untuk informasi tugas. 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

S3 Glacier memperbarui inventaris vault sekitar sekali sehari, dimulai pada hari Anda pertama kali mengunggah arsip ke vault. Jika tidak ada penambahan arsip atau penghapusan vault sejak inventaris terakhir, tanggal inventaris tidak diperbarui. Ketika Anda memulai tugas untuk inventaris vault, S3 Glacier mengembalikan inventaris terakhir yang dihasilkan, yang merupakan point-in-time snapshot dan bukan data real-time. Ingat bahwa setelah S3 Glacier membuat inventaris pertama untuk vault, biasanya diperlukan waktu setengah hari dan sampai satu hari sebelum inventaris tersedia untuk diambil.

Anda mungkin merasa mengambil inventaris vault untuk setiap unggahan arsip tidak berguna. Namun, misalkan Anda menyimpan basis data di metadata yang terkait sisi klien tentang arsip yang Anda unggah ke S3 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.