Mengonfigurasi dokumen kesalahan khusus

Setelah Anda mengonfigurasi bucket Anda sebagai situs web statis, ketika kesalahan terjadi, Amazon S3 mengembalikan dokumen kesalahan HTML. Anda dapat secara opsional mengonfigurasi bucket Anda dengan dokumen kesalahan kustom sehingga Amazon S3 mengembalikan dokumen saat kesalahan terjadi.

catatan

Beberapa browser menampilkan pesan kesalahan mereka sendiri saat terjadi kesalahan, mengabaikan dokumen kesalahan yang dikembalikan Amazon S3. Misalnya, ketika terjadi kesalahan HTTP 404 Not Found, Google Chrome mungkin mengabaikan dokumen kesalahan yang dikembalikan Amazon S3 dan menampilkan kesalahannya sendiri.

Kode respons HTTP Amazon S3

Tabel berikut mencantumkan subset kode respons HTTP yang dikembalikan Amazon S3 saat kesalahan terjadi.

Kode kesalahan HTTP	Deskripsi
301 Dipindahkan Secara Permanen	Saat pengguna mengirimkan permintaan secara langsung ke titik akhir situs web Amazon S3 (http://s3-website.Region.amazonaws.com/), Amazon S3 mengembalikan 301 Dipindahkan Secara Permanen menanggapi dan mengalihkan permintaan tersebut ke https://aws.amazon.com/s3/.
302 Ditemukan	Ketika Amazon S3 menerima permintaan untuk kunci x, http://bucket-name.s3-website.Region.amazonaws.com/x, tanpa garis miring, pertama-tama Amazon akan mencari objek dengan nama kunci x. Jika objek tidak ditemukan, Amazon S3 menentukan bahwa permintaan itu untuk subfolder x dan mengalihkan permintaan dengan menambahkan garis miring di akhir, dan mengembalikan 302 Ditemukan.
304 Tidak Dimodifikasi	Amazon S3 menggunakan header permintaan If-Modified-Since, If-Unmodified-Since, If-Match dan/atau If-None-Match untuk menentukan apakah objek yang diminta sama dengan salinan yang disimpan di cache yang dipegang oleh klien. Jika objek sama, titik akhir situs web mengembalikan 304 Tidak Dimodifikasi tanggapan mereka.
400 Permintaan Berformat Salah	Titik akhir situs web merespons dengan 400 Permintaan Berformat Salah saat pengguna mencoba mengakses bucket melalui titik akhir regional yang salah.
403 Dilarang	Titik akhir situs web merespons dengan 403 Dilarang ketika permintaan pengguna menerjemahkan ke objek yang tidak dapat dibaca oleh publik. Pemilik objek harus membuat objek dapat dibaca oleh publik menggunakan kebijakan bucket atau ACL.
404 Tidak Ditemukan	Titik akhir situs web merespons dengan 404 Tidak Ditemukan karena alasan berikut: Amazon S3 menentukan bahwa URL situs web mengacu pada kunci objek yang tidak ada. Amazon S3 menyimpulkan bahwa permintaan tersebut adalah untuk dokumen indeks yang tidak ada. Bucket yang ditentukan dalam URL tidak tersedia. Terdapat bucket yang disebutkan dalam URL, tetapi tidak dikonfigurasi sebagai situs web. Anda dapat membuat dokumen kustom yang dikembalikan untuk 404 Tidak Ditemukan. Pastikan dokumen diunggah ke bucket yang dikonfigurasi sebagai situs web, dan bahwa konfigurasi hosting situs web diatur untuk menggunakan dokumen. Untuk informasi tentang cara Amazon S3 menginterpretasikan URL sebagai permintaan objek atau dokumen indeks, lihat Mengonfigurasi dokumen indeks.
500 Kesalahan Layanan	Titik akhir situs web merespons dengan 500 Kesalahan Layanan saat terjadi kesalahan server internal.
503 Layanan Tidak Tersedia	Titik akhir situs web merespons dengan 503 Layanan Tidak Tersedia ketika Amazon S3 menentukan bahwa Anda perlu mengurangi tingkat permintaan Anda.

Untuk setiap kesalahan ini, Amazon S3 mengembalikan pesan HTML yang sudah ditentukan sebelumnya. Berikut ini adalah contoh pesan HTML yang dikembalikan untuk respons 403 Dilarang.

Mengonfigurasi dokumen kesalahan khusus

Saat Anda mengonfigurasi bucket sebagai situs web statis, Anda dapat memberikan dokumen kesalahan khusus yang berisi pesan kesalahan dan bantuan tambahan yang mudah digunakan. Amazon S3 mengembalikan dokumen kesalahan kustom Anda hanya untuk kode kesalahan kelas HTTP 4XX saja.

Untuk mengonfigurasi dokumen kesalahan kustom menggunakan konsol S3, ikuti langkah-langkah di bawah ini. Anda juga dapat mengonfigurasi dokumen kesalahan menggunakan REST API, AWS SDK AWS CLI, atau AWS CloudFormation. Untuk informasi selengkapnya, lihat berikut ini:

• PutBucketWebsitedi Referensi API Layanan Penyimpanan Sederhana Amazon

• AWS::S3::Bucket WebsiteConfiguration di Panduan Pengguna AWS CloudFormation

• put-bucket-websitedalam Referensi AWS CLI Perintah

Saat mengaktifkan hosting situs web statis untuk bucket Anda, Anda memasukkan nama dokumen kesalahan (misalnya, 404.html). Setelah Anda mengaktifkan hosting situs web statis untuk bucket, Anda mengunggah file HTML dengan nama dokumen indeks ke bucket Anda.

Untuk mengonfigurasi dokumen kesalahan

1. Membuat dokumen kesalahan, misalnya 404.html.

2. Simpan file dokumen kesalahan secara lokal.

   Nama dokumen kesalahan peka huruf besar/kecil, dan harus sama persis dengan nama yang Anda masukkan saat Anda mengaktifkan hosting situs web statis. Misalnya, jika Anda memasukkan 404.html sebagai nama Dokumen kesalahan di kotak dialog Hosting situs web statis, nama file dokumen kesalahan Anda juga harus bernama 404.html.

3. Masuk ke AWS Management Console dan buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

4. Di daftar Bucket, pilih nama bucket yang ingin Anda gunakan untuk meng-host situs web statis.

5. Aktifkan hosting situs web statis untuk bucket Anda, lalu masukkan nama persis dokumen indeks Anda (misalnya, 404.html). Untuk informasi selengkapnya, lihat Mengaktifkan hosting situs web dan Mengonfigurasi dokumen kesalahan khusus.

   Setelah mengaktifkan hosting situs web statis, lanjutkan ke langkah 6.

6. Untuk mengunggah dokumen kesalahan ke bucket Anda, lakukan salah satu hal berikut ini:

   • Seret dan jatuhkan file dokumen kesalahan ke dalam daftar bucket konsol.

   • Pilih Unggah, dan ikuti petunjuk untuk memilih dan mengunggah file indeks.

   Untuk step-by-step instruksi, lihatMengunggah Objek.