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
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menerima Checksum Saat Mengunduh Data
Ketika Anda mengambil arsip menggunakan API Mulai Tugas (lihat Initiate Job (POSTjobs)), Anda dapat secara opsional menentukan rentang untuk mengambil arsip. Demikian pula, ketika Anda mengunduh data Anda menggunakan API Dapatkan Hasil Tugas (lihat Mendapatkan Output Tugas (GET output)), Anda dapat secara opsional menentukan rentang data yang akan diunduh. Ada dua karakteristik dari rentang ini yang penting untuk dipahami saat Anda mengambil dan mengunduh data arsip Anda. Rentang yang diambil harus megabyte selaras dengan arsip. Kedua rentang yang diambil dan kisaran yang diunduh harus hash pohon yang diseleraskan untuk menerima nilai checksum saat Anda mengunduh data Anda. Definisi dua tipe penyelarasan rentang ini adalah sebagai berikut:
-
Megabyte selaras - Rentang [StartByte, EndBytes] adalah megabyte (1024*1024) sejajar bila habis StartBytesdibagi 1 MB dan EndBytesditambah 1 habis dibagi 1 MB atau sama dengan akhir arsip yang ditentukan (ukuran byte arsip dikurangi 1). Rentang yang digunakan dalam API Mulai Tugas, jika ditentukan, harus megabyte selaras.
-
Tree-hash aligned - Rentang [StartBytes, EndBytes] adalah hash pohon yang disejajarkan sehubungan dengan arsip jika dan hanya jika akar hash pohon yang dibangun di atas rentang setara dengan simpul di hash pohon dari seluruh arsip. Kedua rentang yang diambil dan kisaran yang diunduh harus hash pohon selaras agar dapat menerima nilai checksum untuk data yang Anda unduh. Untuk contoh rentang dan hubungannya dengan hash pohon arsip, lihat Contoh Hash Pohon: Mengambil rentang arsip yang merupakan hash pohon selaras.
Perhatikan bahwa rentang yang merupakan hash pohon selaras juga megabyte selaras. Namun, rentang megabyte selaras belum tentu hash pohon selaras.
Kasus berikut menjelaskan ketika Anda menerima nilai checksum saat Anda mengunduh data arsip Anda:
-
Jika Anda tidak menentukan rentang yang diambil dalam permintaan Initiate Job (Mulai Tugas) dan Anda mengunduh seluruh arsip dalam Permintaan Get Job (Dapatkan Tugas).
-
Jika Anda tidak menentukan rentang yang diambil dalam permintaan Initiate Job (Mulai Tugas) dan Anda menentukan rentang hash pohon selaras yang diunduh dalam Permintaan Get Job (Dapatkan Tugas).
-
Jika Anda menentukan rentang hash pohon selaras yang diambil dalam permintaan Initiate Job (Mulai Tugas) dan Anda mengunduh seluruh rentang dalam Permintaan Get Job (Dapatkan Tugas).
-
Jika Anda menentukan rentang hash pohon selaras yang diambil dalam permintaan Initiate Job (Mulai Tugas) dan Anda menentukan rentang hash tree selaras yang diunduh di Permintaan Get Job (Dapatkan Tugas).
Jika Anda menentukan rentang yang diambil dalam permintaan Initiate Job (Mulai Tugas) yang bukan hash pohon selaras, Anda masih bisa mendapatkan data arsip Anda, tetapi tidak ada nilai checksum yang dikembalikan ketika Anda mengunggah data dalam Permintaan Get Job (Dapatkan Tugas).
Contoh Hash Pohon: Mengambil rentang arsip yang merupakan hash pohon selaras
Misalkan Anda memiliki arsip sebesar 6,5 MB di vault Anda dan Anda ingin mengambil arsip sebesar 2 MB. Cara Anda menentukan rentang 2 MB dalam permintaan Initiate Job (Mulai Tugas) menentukan apakah Anda menerima nilai checksum data saat Anda mengunduh data. Diagram berikut menggambarkan dua rentang 2 MB untuk arsip berukuran 6,5 MB yang dapat Anda unduh. Kedua rentang adalah megabyte selaras, tetapi hanya satu yang merupakan hash pohon selaras.
![Diagram yang menunjukkan pengambilan rentang arsip yang sejajar dengan hash pohon.](images/TreeHash-ArchiveWithRanges.png)
Spesifikasi Rentang Hash Pohon Selaras
Bagian ini memberikan spesifikasi yang tepat untuk apa yang merupakan rentang hash pohon selaras. Rentang hash pohon selaras penting ketika Anda mengunduh sebagian arsip dan Anda menentukan rentang data yang diambil dan rentang yang diunduh dari data yang diambil. Jika kedua rentang ini adalah hash pohon selaras, Anda akan menerima data checksum ketika Anda mengunduh data.
Rentang [A, B] adalah hash pohon selaras yang berkenaan dengan arsip jika dan hanya jika hash pohon baru dibangun di atas [A, B], akar hash pohon dari rentang tersebut sama dengan node di hash pohon seluruh arsip. Anda dapat melihat ini ditunjukkan dalam diagram di Contoh Hash Pohon: Mengambil rentang arsip yang merupakan hash pohon selaras. Pada bagian ini, kami menyediakan spesifikasi untuk penyelarasan hash pohon.
Pertimbangkan [P, Q) sebagai kueri rentang untuk arsip N megabyte (MB) dan P serta Q adalah kelipatan satu MB. Perhatikan bahwa rentang inklusif sebenarnya adalah [P MB, Q MB – 1 byte], tetapi agar ringkas, kami menampilkannya sebagai [P, Q). Dengan pertimbangan ini, maka
-
Jika P adalah angka ganjil, hanya ada satu kemungkinan rentang hash pohon selaras—yaitu [P, P + 1 MB).
-
Jika P adalah bilangan genap dan k adalah jumlah maksimum, dengan P yang dapat ditulis sebagai 2k * X, ada rentang hash pohon selaras k paling banyak yang dimulai dengan P. X adalah bilangan bulat yang lebih besar dari 0. Rentang hash pohon selaras masuk dalam kategori berikut:
-
Untuk setiap i, dengan (0 <= i <= k) dan dengan P + 2i < N, maka [P, Q + 2i) adalah rentang hash pohon selaras.
-
P = 0 adalah kasus khusus dengan A = 2[lgN]*0
-