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.
Mengunggah Arsip (POST archive)
Deskripsi
Operasi ini menambahkan arsip ke vault. Untuk pengunggahan yang berhasil, data Anda akan bertahan lama. Sebagai tanggapan, Amazon Glacier (Amazon Glacier) mengembalikan ID arsip di header respons. x-amz-archive-id Anda harus menyimpan ID arsip yang dikembalikan sehingga Anda dapat mengakses arsip nanti.
Anda harus memberikan hash SHA256 pohon dari data yang Anda unggah. Untuk informasi tentang menghitung hash SHA256 pohon, lihatChecksum Komputasi.
catatan
Hash SHA256 pohon hanya diperlukan untuk tindakan Unggah Arsip (arsip POST) saat menggunakan API. Hal ini tidak diperlukan saat menggunakan AWS CLI.
Saat mengunggah arsip, Anda dapat secara opsional menentukan deskripsi arsip hingga 1.024 karakter ASCII yang dapat dicetak. Amazon Glacier mengembalikan deskripsi arsip saat Anda mengambil arsip atau mendapatkan inventaris brankas. Amazon 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, Amazon 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 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 SHA256 pohon), 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:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-Length:Length<Request body.>
catatan
AccountIdNilainya adalah Akun AWS ID akun yang memiliki brankas. Anda dapat menentukan Akun AWS ID atau secara opsional satu '-' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal 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 lebih lanjut, kunjungi 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 Memulai Tugas (POST jobs)), 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
|
SHA256 Checksum (hash linier) dari payload. 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 SHA256 pohon, dari payload. Untuk informasi tentang menghitung hash SHA256 pohon, lihatChecksum Komputasi. Jika Amazon Glacier menghitung checksum payload yang berbeda, itu akan menolak permintaan tersebut. Tipe: String Default: Tidak ada Batasan: Tidak Ada |
Ya |
Isi Permintaan
Isi permintaan berisi data untuk diunggah.
Respons
Sebagai tanggapan, Amazon 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 arsip dihitung oleh Amazon Glacier. Tipe: String |
Isi Respons
Operasi ini tidak mengembalikan isi respons.
Kesalahan
Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, 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 Location header tempat Anda bisa mendapatkan ID yang ditetapkan Amazon Glacier 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
