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 Layanan Pencarian](search-api.md#search-service-errors)
+ [dokumen/kode status batch](documents-batch-resource.md#documents-batch-status-codes)
+ [Kesalahan Umum Layanan Konfigurasi](CommonErrors.md). Untuk kesalahan spesifik yang dapat dikembalikan dari tindakan tertentu, lihat dokumentasi untuk [tindakan](API_Operations.md) tersebut.
**Topics**
+ [Jenis Kesalahan di Amazon CloudSearch](#error-handling-types)
+ [Mencoba Kembali Permintaan di Amazon CloudSearch](#error-handling-retry)
## Jenis Kesalahan di Amazon CloudSearch
Kode status HTTP yang dikembalikan oleh Amazon CloudSearch APIs 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)](search-api.md#search-response-elements-json) atau[Elemen Respon Pencarian (XHTML)](search-api.md#search-response-elements-xml).
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)](documents-batch-resource.md#documents-batch-json-response) atau [dokumen/Batch Response (XHTML)](documents-batch-xml.md#documents-batch-xml-response).
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, lihat[Kesalahan Umum](CommonErrors.md). Kesalahan khusus tindakan tercantum dalam topik tindakan di. [Referensi API Konfigurasi untuk Amazon CloudSearch](configuration-api.md)
## 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](https://docs.aws.amazon.com/general/latest/gr/api-retries.html).
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](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-cloudsearch-partitions-and-instances) Amazon.
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. Untuk informasi selengkapnya, lihat [Batas](limits.md).