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.
Memulai Unggahan Multipart (POST multipart-uploads)
Deskripsi
Operasi ini memulai unggahan multipart (lihat Mengunggah Arsip Besar dalam Beberapa Bagian (Unggahan Multipart)). Amazon Glacier (Amazon Glacier) membuat sumber daya unggahan multibagian dan mengembalikan ID-nya sebagai respons. Anda menggunakan ID unggahan dalam operasi unggahan multipart selanjutnya.
Ketika memulai unggahan multipart, Anda menentukan ukuran bagian dalam jumlah byte. Ukuran bagian harus mebibyte (MiB) (1024 kibibytes [KiB]) dikalikan dengan kekuatan 2—misalnya, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB), dan seterusnya. Ukuran bagian minimum yang diijinkan adalah 1 MiB, dan maksimum adalah 4 gibibytes (GiB).
Setiap bagian yang Anda unggah menggunakan ID unggah ini, kecuali yang terakhir, harus memiliki ukuran yang sama. Yang terakhir bisa berukuran sama atau lebih kecil. Misalnya, Anda ingin mengunggah file 16,2 MiB. Jika Anda memulai unggahan multipart dengan ukuran bagian 4 MiB, Anda akan mengunggah empat bagian masing-masing 4 MiB dan satu bagian 0,2 MiB.
catatan
Anda tidak perlu mengetahui ukuran arsip saat memulai unggahan multipart karena Amazon Glacier tidak mengharuskan Anda menentukan ukuran arsip keseluruhan.
Setelah Anda menyelesaikan unggahan multibagian, Amazon Glacier menghapus sumber daya unggahan multibagian yang direferensikan oleh ID. Amazon Glacier juga akan menghapus sumber daya unggahan multibagian jika Anda membatalkan unggahan multibagian atau mungkin dihapus jika tidak ada aktivitas selama 24 jam. ID mungkin masih tersedia setelah 24 jam, tetapi aplikasi seharusnya tidak menduga perilaku ini.
Permintaan
Untuk memulai unggahan multipart, Anda mengirim permintaan POST HTTP ke URI subsumber daya multipart-uploads dari vault tempat Anda ingin menyimpan arsip. Permintaan harus mencakup ukuran bagian dan secara opsional dapat menyertakan deskripsi arsip.
Sintaksis
POST /AccountId/vaults/VaultName/multipart-uploads Host: glacier.us-west-2.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01 x-amz-archive-description:ArchiveDescriptionx-amz-part-size:PartSize
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
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 |
|---|---|---|
x-amz-part-size
|
Ukuran setiap bagian kecuali yang terakhir, dalam byte. Bagian terakhir bisa lebih kecil dari ukuran bagian ini. Tipe: String Default: Tidak Ada Kendala: Ukuran bagian harus mebibyte (1024 KiB) dikalikan dengan kekuatan 2 — misalnya, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB), dan seterusnya. Ukuran bagian minimum yang diijinkan adalah 1 MiB, dan maksimum adalah 4 GiB (4096 MiB). |
Ya |
x-amz-archive-description
|
Arsipkan deskripsi yang Anda unggah di bagian. Ini bisa menjadi deskripsi bahasa biasa atau beberapa pengidentifikasi unik yang Anda pilih untuk ditetapkan. Saat Anda mengambil inventaris vault (lihat Memulai Tugas (POST jobs) ), inventaris mencakup deskripsi ini untuk masing-masing arsip yang dikembalikan sebagai respons. Spasi yang mendahului dalam deskripsi arsip akan dihapus. Tipe: String Default: Tidak ada Batasan: Deskripsi harus kurang dari atau sama dengan 1024 byte. Karakter yang diizinkan adalah ASCII 7 bit tanda kode kontrol, khususnya nilai ASCII 32-126 desimal atau 0x20-0x7E heksadesimal. |
Tidak |
Isi Permintaan
Operasi ini tidak memiliki isi permintaan.
Respons
Sebagai tanggapan, Amazon Glacier membuat sumber daya unggahan multibagian yang diidentifikasi oleh ID dan mengembalikan jalur URI relatif dari ID unggahan multibagian.
Sintaksis
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location x-amz-multipart-upload-id: multiPartUploadId
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 | Penjelasan |
|---|---|
Location
|
Jalur URI relatif dari ID unggahan multibagian Amazon Glacier dibuat. Anda menggunakan jalur URI ini untuk mencakup permintaan Anda untuk mengunggah bagian, dan untuk menyelesaikan unggahan multipart. Tipe: String |
x-amz-multipart-upload-id
|
ID unggahan multipart. Nilai ini juga disertakan sebagai bagian dari header 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 memulai unggahan multipart dengan mengirimkan permintaan POST HTTP ke URI dari subsumber daya multipart-uploads dari vault bernama examplevault. Permintaan termasuk header untuk menentukan ukuran bagian dari 4 MiB (4194304 byte) dan deskripsi arsip opsional.
POST /-/vaults/examplevault/multipart-uploads Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-archive-description: MyArchive-101 x-amz-part-size: 4194304 x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Contoh Respons
Amazon Glacier membuat sumber daya unggahan multibagian dan menambahkannya ke subsumber daya brankasmultipart-uploads. Header respons Location termasuk jalur URI relatif ke ID unggahan multipart.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
Untuk informasi tentang mengunggah bagian-bagian individu, lihat Mengunggah Bagian (PUT UploadID).
Bagian Terkait
