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.
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-id
dari 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 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 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