View a markdown version of this page

Header permintaan umum - Amazon Simple Storage Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Header permintaan umum

Tabel berikut menjelaskan header yang dapat digunakan oleh berbagai jenis permintaan REST Amazon S3.

Nama Header Deskripsi
Authorization

Informasi yang diperlukan untuk otentikasi permintaan. Untuk informasi selengkapnya, buka Header Otentikasi di Panduan Pengembang Layanan Penyimpanan Sederhana Amazon. Untuk permintaan anonim header ini tidak diperlukan.
Access-Control-Request-Method Daftar metode HTTP yang dikirim sebagai permintaan CORS pra-penerbangan. Jika evaluasi CORS pra-penerbangan berhasil, maka metode yang ditentukan diizinkan untuk digunakan dalam permintaan CORS berikut.
Content-Length

Panjang pesan (tanpa header) sesuai dengan RFC 2616. Header ini diperlukan untuk PUT dan operasi yang memuat XML, seperti logging dan ACL.
Content-Type

Jenis konten sumber daya jika permintaan memiliki konten dalam tubuh. Contoh: text/plain
Content-MD5

Base64 mengkodekan ringkasan pesan MD5 128-bit (tanpa header) menurut RFC 1864. Header ini dapat digunakan sebagai pemeriksaan integritas pesan untuk memverifikasi bahwa data adalah data yang sama dengan yang awalnya dikirim. Meskipun opsional, kami sarankan menggunakan Content-MD5 mekanisme sebagai pemeriksaan integritas ujung ke ujung. Untuk informasi selengkapnya tentang otentikasi permintaan REST, buka Otentikasi RES T di Panduan Pengembang Layanan Penyimpanan Sederhana Amazon.
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, date/time Wed, 01 Mar 2006 12:00:00 GMT adalah date/time header yang valid untuk digunakan dengan Amazon S3.

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

Jika Date ditentukan tetapi tidak dalam format dasar ISO 8601, maka Anda juga harus menyertakan x-amz-date header. 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.

Expect

Ketika aplikasi Anda menggunakan 100-continue, aplikasi tidak mengirim isi permintaan sampai menerima pengakuan. Jika pesan ditolak berdasarkan header, isi pesan tidak akan terkirim. Header ini hanya dapat digunakan jika Anda mengirim tubuh.

Nilai yang Valid: 100-lanjutan
Host

Untuk permintaan gaya jalur, nilainya adalah. s3.amazonaws.com Untuk permintaan gaya virtual, nilainya adalah. BucketName.s3.amazonaws.com Untuk informasi selengkapnya, buka Virtual Hosting di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Header ini diperlukan untuk HTTP 1.1 (sebagian besar toolkit menambahkan header ini secara otomatis); opsional untuk HTTP/1.0 permintaan.
Origin

Titik akhir yang menentukan nama server dari pemohon awal.
x-amz-content-sha256

Saat menggunakan tanda tangan versi 4 untuk mengotentikasi permintaan, header ini menyediakan hash payload permintaan. Untuk mengetahui informasi selengkapnya, lihat Perhitungan Tanda Tangan untuk Header Otorisasi: Mentransfer Payload dalam Satu Potongan (AWS Versi Tanda Tangan 4). Saat mengunggah objek dalam potongan, Anda menetapkan nilai STREAMING-AWS4-HMAC-SHA256-PAYLOAD untuk menunjukkan bahwa tanda tangan hanya mencakup header dan tidak ada payload. Untuk informasi selengkapnya, lihat Perhitungan Tanda Tangan untuk Header Otorisasi: Mentransfer Payload dalam Beberapa Potongan (Unggahan Terpotong) (AWS Versi Tanda Tangan 4).

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, date/time 20170210T120000Z valid x-amz-date untuk digunakan dengan Amazon S3.

x-amz-datebersifat opsional untuk semua permintaan; dapat digunakan untuk mengganti 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.

x-amz-security-token

Header ini dapat digunakan dalam skenario berikut:

  • Untuk menyediakan token keamanan untuk DevPay operasi Amazon - Setiap permintaan yang menggunakan Amazon DevPay memerlukan dua x-amz-security-token header: satu untuk token produk dan satu untuk token pengguna. Saat Amazon S3 menerima permintaan yang diautentikasi, Amazon S3 membandingkan tanda tangan yang dihitung dengan tanda tangan yang disediakan. Header multi-nilai yang diformat secara tidak benar yang digunakan untuk menghitung tanda tangan dapat menyebabkan masalah otentikasi.

  • Untuk memberikan token keamanan saat menggunakan kredenSIAL keamanan sementara - Saat membuat permintaan menggunakan kredenSIAL keamanan sementara yang Anda peroleh dari IAM, Anda harus memberikan token keamanan dengan menggunakan header ini. Untuk mempelajari lebih lanjut tentang kredentif keamanan sementara, lihat Membuat Permintaan.

Header ini diperlukan untuk permintaan yang menggunakan Amazon DevPay dan permintaan yang ditandatangani dengan menggunakan kredentif keamanan sementara.