Header Permintaan Umum - Amazon Glacier

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, yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke 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.

Header Permintaan Umum

Permintaan REST Amazon Glacier (Amazon Glacier) menyertakan header yang berisi informasi dasar tentang permintaan tersebut. Tabel berikut menjelaskan header yang dapat digunakan oleh semua permintaan Amazon Glacier REST.

Nama Header Deskripsi Wajib
Authorization

Header yang diperlukan untuk menandatangani permintaan. Amazon Glacier membutuhkan Signature Versi 4. Untuk informasi selengkapnya, lihat Menandatangani Permintaan.

Tipe: String

Ya
Content-Length

Panjang isi permintaan (tanpa header).

Tipe: String

Syarat: Diperlukan hanya untuk API Mengunggah Arsip (POST archive).

Bersyarat
Date

Tanggal yang dapat digunakan untuk membuat tanda tangan yang terdapat dalam header Authorization. Jika header Date digunakan untuk penandatanganan, header harus ditentukan dalam format dasar ISO 8601. Dalam hal ini, header x-amz-date tidak diperlukan. Perhatikan bahwa ketika x-amz-date tersedia, nilai header Date akan selalu ditimpa.

Jika header Tanggal tidak digunakan untuk penandatanganan, header tersebut bisa menjadi salah satu dari format tanggal penuh yang ditentukan oleh RFC 2616, bagian 3.3. Misalnya, tanggal/waktu berikut Wed, 10 Feb 2017 12:00:00 GMT adalah date/time header yang valid untuk digunakan dengan Amazon Glacier.

Jika Anda menggunakan header Date untuk penandatanganan, header tersebut harus dalam format YYYYMMDD'T'HHMMSS'Z' dasar ISO 8601.

Tipe: String

Syarat: Jika Date ditentukan, tetapi tidak dalam format dasar ISO 8601, Anda juga harus menyertakan header x-amz-date. Jika Date ditentukan dalam format dasar ISO 8601, ini cukup untuk menandatangani permintaan dan Anda tidak memerlukan header x-amz-date. Untuk informasi selengkapnya, lihat Menangani Tanggal dalam Signature Versi 4 di Glosarium Amazon Web Services.

Bersyarat
Host

Header ini menentukan titik akhir layanan tempat Anda mengirim permintaan Anda. Nilai harus dari bentuk "glacier.region.amazonaws.com“, di region mana diganti dengan sebutan AWS Region sepertius-west-2.

Tipe: String

Ya
x-amz-content-sha256

SHA256 Checksum yang dihitung dari seluruh muatan yang diunggah dengan salah satu atau. Mengunggah Arsip (POST archive) Mengunggah Bagian (PUT UploadID) Header ini tidak sama dengan header x-amz-sha256-tree-hash, meskipun, untuk beberapa muatan kecil, nilai-nilainya sama. Ketika x-amz-content-sha256 wajib diisi, x-amz-content-sha256 dan x-amz-sha256-tree-hash harus ditentukan.

Tipe: String

Syarat: Diperlukan untuk streaming API,Mengunggah Arsip (POST archive) dan Mengunggah Bagian (PUT UploadID).

Bersyarat
x-amz-date

Tanggal yang digunakan untuk membuat tanda tangan di header Otorisasi. Format harus berupa ISO 8601 dasar dalam format YYYYMMDD'T'HHMMSS'Z'. Misalnya, berikut ini date/time 20170210T120000Z valid x-amz-date untuk digunakan dengan Amazon Glacier.

Tipe: String

Syarat: x-amz-date bersifat opsional untuk semua permintaan; ini dapat digunakan untuk menimpa tanggal yang digunakan untuk menandatangani permintaan. Jika Date ditentukan dalam format dasar ISO 8601, x-amz-date tidak diperlukan. Ketika x-amz-date tersedia, nilai header Date akan selalu ditimpa. Untuk informasi selengkapnya, lihat Menangani Tanggal dalam Signature Versi 4 di Glosarium Amazon Web Services.

Bersyarat
x-amz-glacier-version

Versi Amazon Glacier API untuk digunakan. Versi saat ini adalah 2012-06-01.

Tipe: String

Ya
x-amz-sha256-tree-hash

Checksum SHA256 hash pohon yang dihitung untuk arsip () atau bagian arsip (Mengunggah Arsip (POST archive)) yang diunggah. Mengunggah Bagian (PUT UploadID) Untuk informasi selengkapnya tentang menghitung checksum ini, lihat Checksum Komputasi.

Tipe: String

Default: Tidak ada

Syarat: Diperlukan untuk Mengunggah Arsip (POST archive) dan Mengunggah Bagian (PUT UploadID).

Bersyarat