Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menangani Kesalahan di Amazon CloudSearch
Bagian ini memberikan informasi tentang cara menangani kesalahan saat berinteraksi dengan Amazon secara CloudSearch terprogram. Untuk informasi tentang kode kesalahan tertentu yang ditampilkan oleh CloudSearch layanan Amazon, lihat:
Kesalahan Umum Layanan Konfigurasi. Untuk kesalahan spesifik yang dapat dikembalikan dari tindakan tertentu, lihat dokumentasi untuk tindakan tersebut.
Jenis Kesalahan di Amazon CloudSearch
Kode status HTTP yang dikembalikan oleh Amazon CloudSearch API menunjukkan apakah permintaan berhasil diselesaikan, atau jika terjadi kesalahan klien atau server saat memproses permintaan:
Kode status 2xx menunjukkan bahwa permintaan klien berhasil diproses.
Kode status 4xx menunjukkan bahwa ada masalah dengan permintaan klien. Kesalahan permintaan klien yang umum termasuk memberikan kredensi yang tidak valid dan menghilangkan parameter yang diperlukan. Ketika Anda mendapatkan kesalahan 4xx, Anda perlu memperbaiki masalah dan mengirimkan kembali permintaan klien yang dibentuk dengan benar.
Kode status 5xx menunjukkan bahwa kesalahan server terjadi saat memproses permintaan klien. Kesalahan server biasanya bersifat sementara dan seringkali merupakan hasil dari batas waktu server, pembatasan, atau keterbatasan kapasitas. Kami merekomendasikan untuk menangkap dan mencoba kembali semua kesalahan 5xx.
Kode status HTTP dikembalikan untuk setiap permintaan. Selain itu, badan respons memberikan peringatan tambahan dan informasi kesalahan.
Pesan dalam search respons menunjukkan tingkat keparahan, peringatan atau kode kesalahan, dan deskripsi masalah dengan permintaan pencarian. Untuk daftar peringatan dan kesalahan yang dapat dikembalikan oleh layanan pencarian, lihat Cari Properti Respon (JSON) atauElemen Respon Pencarian (XHTML).
Kesalahan dan peringatan dalam documents/batch respons memberikan informasi tentang masalah parsing dan validasi yang dihadapi saat memproses data dokumen. Untuk informasi selengkapnya, lihat dokumen/Batch Response (JSON) atau dokumen/Batch Response (XHTML).
Kesalahan yang dikembalikan dalam respons layanan konfigurasi memberikan informasi tentang apa yang menyebabkan permintaan mengembalikan kode status 4xx atau 5xx. Untuk informasi tentang kesalahan umum yang digunakan semua tindakan, lihatKesalahan Umum. Kesalahan khusus tindakan tercantum dalam topik tindakan di. APIReferensi Konfigurasi untuk Amazon CloudSearch
Mencoba Kembali Permintaan di Amazon CloudSearch
Agar aplikasi Anda berjalan dengan lancar, Anda perlu membangun logika untuk menangkap dan merespons kesalahan. Salah satu pendekatan tipikal adalah mengimplementasikan permintaan Anda dalam blok coba atau pernyataan jika-maka.
Kami merekomendasikan untuk menangkap dan mencoba kembali semua kesalahan server (5xx). Karena kesalahan dapat dihasilkan dari mana saja dalam pipeline permintaan, Anda harus menerapkan fallback untuk kesalahan 5xx yang tidak terduga selain penanganan khusus untuk kode status tertentu.
Kesalahan 507 dan 509 biasanya menunjukkan bahwa layanan pencarian Anda kelebihan beban. Hal ini dapat disebabkan oleh volume atau kompleksitas permintaan pencarian yang Anda kirimkan. Amazon CloudSearch biasanya menskalakan secara otomatis untuk menangani beban. Karena membutuhkan waktu untuk menerapkan instance penelusuran tambahan, sebaiknya gunakan kebijakan coba ulang backoff eksponensial untuk mengurangi tingkat permintaan sementara dan meminimalkan kegagalan permintaan. Untuk informasi selengkapnya, lihat Error Retries and Exponential Backoff.
Pola penggunaan tertentu, seperti mengirimkan kueri penelusuran yang kompleks ke satu contoh penelusuran kecil, terkadang dapat menghasilkan batas waktu tanpa memicu penskalaan otomatis. Jika Anda berulang kali mengalami tingkat kesalahan yang tinggi, Anda dapat secara eksplisit meminta kapasitas tambahan melalui formulir Permintaan Batas CloudSearch Layanan
Kesalahan klien (4xx) biasanya menunjukkan bahwa Anda perlu merevisi permintaan untuk memperbaiki masalah — cukup mencoba kembali permintaan yang sama kemungkinan besar akan menghasilkan kesalahan yang sama. 409 kesalahan yang dikembalikan oleh layanan konfigurasi dapat menunjukkan bahwa permintaan ditolak karena batas sumber daya telah tercapai. Lihat informasi yang lebih lengkap di Batas.
