Header Permintaan Umum - 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.

Header Permintaan Umum

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

Nama Header Deskripsi Wajib
Authorization

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

Jenis: Tali

 Ya
Content-Length

Panjang isi permintaan (tanpa header).

Jenis: String

Kondisi: Diperlukan hanya untukMengunggah Arsip (POST archive)API

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. Sebagai contoh, tanggal/waktu berikut Wed, 10 Feb 2017 12:00:00 GMT adalah header tanggal/waktu yang valid untuk digunakan dengan S3 Glacier.

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

Jenis: String

Kondisi: JikaDateditentukan, tetapi tidak dalam format dasar ISO 8601, Anda juga harus menyertakanx-amz-dateHeader. 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 dalam bentuk "glacier.region.amazonaws.com", dengan wilayah ditempatkan dengan AWS Tujuan wilayah seperti us-west-2.

Jenis: Tali

 Ya
x-amz-content-sha256

Checksum SHA256 terkomputasi dari seluruh muatan yang diunggah dengan Mengunggah Arsip (POST archive) atau 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.

Jenis: String

Kondisi: Diperlukan untuk streaming API,Mengunggah Arsip (POST archive)danMengunggah 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'. Sebagai contoh, nilai tanggal/waktu berikut 20170210T120000Z valid x-amz-date untuk digunakan dengan S3 Glacier.

Jenis: 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 API S3 Glacier yang digunakan. Versi saat ini adalah 2012-06-01.

Jenis: Tali

 Ya
x-amz-sha256-tree-hash

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

Jenis: String

Default: Tidak ada

Kondisi: Diperlukan untukMengunggah Arsip (POST archive)danMengunggah Bagian (PUT UploadID).

 Bersyarat