Mengunggah Arsip (POST archive) - Amazon S3 Glacier

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.

Mengunggah Arsip (POST archive)

Deskripsi

Operasi ini menambahkan arsip ke vault. Untuk pengunggahan yang berhasil, data Anda akan bertahan lama. Sebagai respons, Amazon S3 Glacier (S3 Glacier) mengembalikan ID arsip di header x-amz-archive-iddari respons. Anda harus menyimpan ID arsip yang dikembalikan sehingga Anda dapat mengakses arsip nanti.

Anda harus menyediakan hash pohon SHA256 dari data yang Anda unggah. Untuk informasi tentang mengomputasi hash pohon SHA256, lihat Checksum Komputasi.

catatan

Hash pohon SHA256 hanya diperlukan untuk tindakan Upload Archive (POST archive) saat menggunakan API. Hal ini tidak diperlukan saat menggunakanAWS CLI.

Saat mengunggah arsip, Anda dapat secara opsional menentukan deskripsi arsip hingga 1.024 karakter ASCII yang dapat dicetak. S3 Glacier mengembalikan deskripsi arsip ketika Anda mengambil arsip atau mendapatkan inventaris vault. S3 Glacier tidak menafsirkan deskripsi dengan cara apa pun. Deskripsi arsip tidak harus unik. Anda tidak dapat menggunakan deskripsi untuk mengambil atau mengurutkan daftar arsip.

Kecuali untuk deskripsi arsip opsional, S3 Glacier tidak mendukung metadata tambahan apa pun untuk arsip. ID arsip adalah urutan buram karakter tempat Anda tidak dapat menyimpulkan makna apa pun tentang arsip. Jadi, Anda dapat mempertahankan metadata tentang arsip di sisi klien. Untuk informasi selengkapnya, lihat Bekerja dengan Arsip di Amazon S3 Glacier.

Arsip bersifat tetap. Setelah mengunggah arsip, Anda tidak dapat mengedit arsip atau deskripsinya.

Permintaan

Untuk mengunggah arsip, Anda menggunakan metode POST HTTP dan mencakup permintaan ke subsumber daya archives dari vault tempat Anda ingin menyimpan arsip. Permintaan harus menyertakan ukuran muatan arsip, checksum (hash pohon SHA256), dan secara opsional dapat menyertakan deskripsi arsip.

Sintaksis

POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date: Date Authorization: SignatureValue x-amz-archive-description: Description x-amz-sha256-tree-hash: SHA256 tree hash x-amz-content-sha256: SHA256 linear hash Content-Length: Length <Request body.>

catatan

Nilai AccountId adalah ID Akun AWS dari akun yang memiliki vault. Anda dapat menentukan ID Akun AWS atau secara opsional satu '-' (tanda hubung), dalam hal ini, Amazon S3 Glacier menggunakan ID Akun AWS yang terkait dengan kredensial yang digunakan untuk menandatangani permintaan. Jika Anda menggunakan ID akun, jangan sertakan tanda hubung ('-') di ID.

Parameter Permintaan

Implementasi operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

Operasi ini menggunakan header permintaan berikut, selain header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat Header Permintaan Umum.

Nama Deskripsi Wajib
Content-Length

Ukuran objek, dalam byte. Untuk informasi selengkapnya, buka http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13.

Jenis: Angka

Default: Tidak ada

Batasan: Tidak Ada

Ya
x-amz-archive-description

Deskripsi opsional dari arsip yang Anda unggah. Ini bisa menjadi deskripsi bahasa biasa atau beberapa pengidentifikasi yang Anda pilih untuk ditetapkan. Deskripsi tidak harus unik di seluruh arsip. Saat Anda mengambil inventaris vault (lihat Initiate Job (POSTjobs)), inventaris mencakup deskripsi ini untuk masing-masing arsip yang dikembalikan sebagai respons.

Tipe: String

Default: Tidak ada

Batasan: Deskripsi harus kurang dari atau sama dengan 1.024 karakter. Karakter yang diizinkan adalah ASCII 7-bit tanpa kode kontrol, khususnya nilai ASCII 32—126 desimal atau 0x20—0x7E heksadesimal.

Tidak
x-amz-content-sha256

Checksum SHA256 (hash linear) dari muatan. Ini bukan nilai yang sama seperti yang Anda tentukan di header x-amz-sha256-tree-hash.

Tipe: String

Default: Tidak ada

Batasan: Tidak Ada

Ya
x-amz-sha256-tree-hash

Checksum yang dihitung pengguna, hash pohon SHA256, dari muatan. Untuk informasi tentang mengomputasi hash pohon SHA256, lihat Checksum Komputasi. Jika S3 Glacier menghitung checksum muatan yang berbeda, S3 Glacier akan menolak permintaan.

Tipe: String

Default: Tidak ada

Batasan: Tidak Ada

Ya

Isi Permintaan

Isi permintaan berisi data untuk diunggah.

Respons

Sebagai respons, S3 Glacier menyimpan arsip dengan tahan lama dan mengembalikan jalur URI ke ID arsip.

Sintaksis

HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location x-amz-archive-id: ArchiveId

Header Respons

Respons yang sukses termasuk header respon berikut, selain header respons yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header respons umum, lihat Header Respons Umum.

Nama Deskripsi
Location

Jalur URI relatif dari sumber daya arsip yang baru ditambahkan.

Tipe: String

x-amz-archive-id

ID arsip. Nilai ini juga disertakan sebagai bagian dari header Location.

Tipe: String

x-amz-sha256-tree-hash

Checksum dari arsip dihitung oleh S3 Glacier.

Tipe: String

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.

Contoh

Contoh Permintaan

Contoh berikut menunjukkan permintaan untuk mengunggah arsip.

POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace <Request body (2097152 bytes).>

Contoh Respons

Respons yang berhasil di bawah ini memiliki header Location tempat Anda bisa mendapatkan ID yang S3 Glacier tugaskan ke arsip.

HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

Bagian Terkait